Ушакова — директор буковок
1.21K subscribers
268 photos
15 videos
252 links
Екатерина Ушакова
@ushkatia

Про мой опыт и форматы взаимодействия: ringova.com
Download Telegram
Очередное продуктивное приложение с одной стороны

С другой — нетривиальная идея и статья о продуктовом процессе за этим приложением

Что понравилось

👌 у автора свой подход к планированию — я такое люблю, а не просто натягивание чужих фреймворков
👌 в статье есть анализ почему пошло не по плану
👌 приложение продолжает адаптироваться под фактические запросы аудитории

#monday_link
Please open Telegram to view this post
VIEW IN TELEGRAM
👍5
Пока подаю заявки на конференции и жду в себе смелости анонсировать те, куда меня уже приняли, держите инструкцию по подготовке докладов 🐈‍⬛


1. Прикинуть аудиторию и основной посыл своего доклада: что хотелось бы донести и до кого.

2. Набрать свалку из всего-всего по теме. При чём сама свалка вам больше не пригодится, скорее всего, но откалибрует ваш взгляд на проблему.

3. Составить примерную рыбу доклада. Прям очень поверхностно — вот тут это расскажу, сюда картинку с котиком добавлю, а здесь блок для вопросов.

🐈‍⬛ 4. Пойти и об кого-то подумать пункты 1 и 3. Внести правки, вывести окончательную тему и структуру.

5. Наполнить презентацию "мясом" — текстом, графиками, мемасиками etc. Это всё ещё черновой этап, не пытайтесь сделать всё.

6. Рассказать сами себе, можно записать на видео. Например, как сделал Кирилл Анастасин. Пересматривать необязательно, все проплешины всплывут в процессе.

7. Рассказать кому-то, желательно и людям из четвёртого пункта.

🐈‍⬛ 8. Внести финальные доработки, отрепетировать ещё пару раз перед зеркалом.

9. Подготовить список полезных материалов, которыми можно поделиться с аудиторией после доклада.


🐈‍⬛ Лайфхак: можно отдельные куски доклада прогонять на командных созвонах. И коллегам что-то полезное расскажете, и мнения услышите.

🐈‍⬛ Варнинг: слишком много мнений тоже вредно, ищите свою золотую середину в каждом пункте
Please open Telegram to view this post
VIEW IN TELEGRAM
👍116💯31🔥1
Привет! Довольно много людей подписалось в последние недели, поэтому

Привет, я Катя 🐸

Скорее всего мы познакомились на обучении ЦЕХ или вы слушали подкаст в Техпис Говорит 🐸

Или же мы увидимся на Стачке 15-16 сентября и поговорим о документации лично 🐸

В любом случае — если есть что-то, чем я могу быть полезна — может, вы давно хотели узнать больше о техписателях, управлении командами, яхтинге, корейском языке, поездках или чём угодно другом — пишите в комментарии или в личные сообщения 🐸



🐸 Самые популярные посты so far 🐸

Подборка книг для тимлидов

Почему со скринами в доке надо осторожно

Как стать хорошим техписателем

Подборка базовых материалов для текстоделов
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥10❤‍🔥4🙏1🐳1
Насмотренность

Одно из важнейших качеств хорошего писателя — насмотренность на тексты

😵‍💫Насмотренность — это способность внимательно и с интересом изучать разнообразные тексты. Это может быть всё что угодно: книги, статьи, блоги, рекламные листовки — главное, чтобы мы могли увидеть, что в них хорошо, а что — не очень.

👾 Насмотренность позволяет нам лучше воспринимать информацию. Когда мы читаем много текстов, наше внимание и концентрация тренируются, поэтому читать становится легче.

👾 Чтение примеров хорошего и качественного текста помогает нам лучше понять, как эти тексты построены, какой стиль использован, какие приёмы и методы можно использовать. Мы учимся быть более точными, чёткими и выразительными в своих собственных текстах.

👾 И, как следствие, насмотренность развивает наш собственный стиль письма. Когда мы видим разные подходы авторов, разные стили и тон, мы можем выбирать, что нам нравится и что соответствует нашей индивидуальности. Постепенно мы развиваем свой уникальный стиль, который помогает выделиться среди других писателей и улучшает наши тексты.

🤤 Поэтому, если вы хотите стать более эффективным в письме, не забывайте тренировать свою насмотренность:

🥺 читайте разнообразные и качественные тексты,
🥺 изучайте разные стили и приемы,
🥺 обратите внимание на то, как другие авторы выражают свои мысли.

#sponsored_by_AI
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥8💯2
как я могу помочь?

за последний месяц я написала эту фразу намного больше раз, чем хотелось бы

и я полностью понимаю, что люди в тех ситуациях, скорее всего, ничего конкретного мне не скажут

как я могу помочь? — это вместо просто обнять, просто взять за руку, просто помолчать

но просто помолчать на расстоянии сложно

поэтому приходится снова спрашивать

как я могу помочь?
❤‍🔥22💔3
Один из моих основных тезисов о том, что подходов и мнений много, но

надо знать как можно больше подходов и мнений, чтобы выбрать из них те элементы, которые подходят конкретно тебе в конкретно твоей ситуации


Поэтому держите ещё один подход к управлению командами

🐱 Управление как игра
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥32👌1
Что общего между программистами, дизайнерами и писателями?

Ответ не очевиден: с появлением технических писателей они найдут общий язык.

Технические писатели — это профессионалы, которые специализируются на создании понятного и доступного технического контента.

Они создают документацию для продуктов и сервисов, которая помогает пользователям разобраться в функциональностях и возможностях. Важный навык для техписателя — уметь общаться как с разработчиками, для получения необходимой информации, так и с пользователями, чтобы перевести сложные технические термины на понятный язык.

Технический писатель может работать и с внутренней командой разработки, облегчая коммуникацию и совместную работу, и с внешними пользователями, помогая им легче адаптироваться к продукту или сервису.

Важно понимать, что работа технических писателей важна не только для разработчиков, но и для привлечения и удержания клиентов. Качественная и понятная документация может стать преимуществом компании и помочь ей занять лидирующую позицию на рынке.

🖇 What does a Technical Writer Do?

#sponsored_by_AI
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥6👨‍💻21
Если вы ещё не проводите 1-1, то эти 40 шаблонов идут к вам:

https://templatelab.com/one-to-one-meeting/

А если проводите — они всё равно к вам идут с новыми идеями 💡

#monday_link
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥10👨‍💻1
Избыточная детализация доки

Что может быть хуже, чем пытаться разобраться в запутанной технической документации? Избыточная детализация может быть настоящей головной болью для пользователей, которые пытаются разобраться в продукте или решить проблему.

При написании технической документации нет необходимости вдаваться во все детали и мелочи, которые могут только запутать пользователей. Возможно, вы отлично знаете все характеристики и функции своего продукта, но пользователи обычно ищут простые и понятные ответы на свои вопросы. Или они хотят быстро ознакомиться с возможностями продукта, не тратя много времени на чтение длинной документации.

Излишняя детализация не только затрудняет чтение, но и может привести к неправильному использованию продукта. Пользователь может запутаться во множестве технических терминов или не суметь разобраться, что именно ему нужно сделать.

Это может привести к негативному опыту использования продукта и даже к его возврату или негативным отзывам.

Чтобы избежать этой проблемы, рекомендуется рассмотреть аудиторию, для которой была написана документация. Подумайте о том, какой уровень знаний у ваших пользователей и что они ожидают найти в документации. Адаптируйте свои материалы под их потребности и предоставьте только необходимую информацию.

Краткость и ясность — вот ключевые принципы, которых следует придерживаться при написании технической документации. Она должна быть понятной и доступной даже для тех, кто не имеет специального образования. Если пользователь может быстро найти нужную информацию и понять, каким образом использовать продукт, это повысит его удовлетворенность и вероятность повторной покупки.

Помните, что техническая документация не должна быть скучной и сложной. Она должна быть полезной, понятной и помогать пользователям в использовании продукта без лишних затруднений.

#sponsored_by_AI
🔥8👌21
А ещё можно использовать промокод «Ушакова», чтобы купить билет со скидкой 10%
Please open Telegram to view this post
VIEW IN TELEGRAM
❤‍🔥3
🙃Руководитель отдела технической документации в Ozon Tech, где пишут технические инструкции и документацию для пользователей.

Екатерина Ушакова введет вас в мир технической документации: вы узнаете разницу между пользовательской, технической, проектной и организационной документацией, о цикле подготовки и его элементах, о метриках — от CSI до KPI и почему стоит дважды подумать, добавлять ли формы обратной связи.

Екатерина выступит на секции “Копирайтинг”.

Решение есть - все #nastachku!🐶
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥14🤩5👍1😱1
Прокрастинируя, наткнулась на видео о прокрастинации 👑

Как и с остальными внезапными хотелками мозга — достаточно остановиться и подумать что же надо организму на самом деле

Но проще сказать, чем сделать, да 😵‍💫

И ещё напоминание: продуктивность — это иллюзия, не стоит за ней гнаться, если организму не надо 🙂
Please open Telegram to view this post
VIEW IN TELEGRAM
9
Ради короткой поездки можно язык и не учить, конечно 🐸

Но это же не единственный повод узнать больше о другой культуре? 🌵

О бенефитах билингвального мышления — в видео от TED-Ed 🌷

#monday_link
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥41👌1
Поскольку Ozon уже есть не только в России, то и Справки мы пишем не только на русском 😎

На хабре есть статья о том, на каких рельсах мы пишем доки: Делаем документацию здорового человека в Git на примере Docs Ozon

C момента публикации ничего радикально не поменялось в инструменте, а вот стран для локализации прибавилось 😅

У Hugo SSG есть коробочная работа с языками, но проблема в том, что просто перевести недостаточно.

Например, для пользователей из Казахстана достаточно Справки на русском языке. А вот сама информация будет отличаться. Например, другие провайдеры доставки или самое простое — там, где для России мы пишем «почта России», для Казахстана будет «СДЭК», но при этом остальной текст будет одинаковым и для РФ, и для Казахстана.

Такое переиспользование мы сделали на кастомных шорткодах Hugo — внутри шорткода мы указываем страну, для которой надо отображать ту или иную информацию. Это может быть одно слово, абзац или целая статья.

В итоге мы смотрим какую страну выбрал пользователь и показываем только актуальную для него информацию.

А первой идеей было просто написать Справку для каждой страны отдельно 😵‍💫
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥9🥰3👌2
Локализация и перевод

Локализация текста и его перевод — два понятия, которые часто путают между собой

Локализация текста — это адаптация контента культурной и языковой среде конкретной аудитории. В ходе локализации не только происходит перевод текста на другой язык, но и учитываются все особенности и нюансы местной культуры. Например, это может включать замену изображений, иконок, цветовой палитры, адаптацию форматирования дат и времени, введение местных единиц измерения etc.

Перевод текста подразумевает просто передачу значения одного языка на другой. Он не учитывает контекст и культурные особенности, а сконцентрирован на точном и адекватном переводе смысла. Здесь важна грамматическая и лингвистическая точность.

Итого, разница между локализацией текста и переводом в том, что локализация учитывает культурные особенности, в то время как при переводе акцент смещается на точный перевод.

#sponsored_by_AI
👍10👨‍💻21
Есть один монтажёр — Джордан Орм

У него есть много крутых работ и ещё больше крутых реакций на к-поп клипы 😄

Чтобы узнать, что такого в этих ваших к-поп видео — просто посмотрите разборы от Джордана

Например, мои любимые ITZY — Cake или Stray Kids — S-Class ☺️

Хинт: чтобы смотреть видео на YouTube с переводом Алисы — используйте Яндекс.Браузер и фичу "Перевести видео" 🥺
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥3😍2
Сегодня я к вам с анонсом

У нас открывается вакансия

В отдел технических писателей Ozon Tech ищем специалиста со знанием английского языка 🐈

Человек нужен на задачи по документациям для зарубежных пользователей. Но у нас есть и API, и внутренности разработки Ozon — можно переключаться и изучать что-то новое 🐣

Гарантируем docs-as-code, вычитки и отсутствие ГОСТов 🐱

Резюме можно слать мне в личку — @ushkatia 💌
Please open Telegram to view this post
VIEW IN TELEGRAM
🔥94😱2🤩1