Видеодокументация

На Хабре вышла статья про то, как технический писатель снимает видеоролики.

Ну, вышла и вышла, что в этом такого

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

Про сценарии

Не все технические писатели готовы сами все монтировать и снимать, но поучаствовать в создании сценария стоит. Это не займет много времени, потому что вы уже написали все в документации. И структура видеоролика похожа на страницу документации.
Сначала введение, где вы рассказываете, про какую фичу видео и какие проблемы эта фича решает. Дальше основная часть, какие кнопочки в интерфейсе надо нажать, чтобы заработало. Потом можно добавить совет с какой-то полезной, но при этом необязательной информацией. И в конце вывод и призыв, такого в документации обычно нет, придется написать.

Идеальный мир

Несколько лет назад я считала, что видеоролики в документации — это трата времени и денег, а смотреть их никто не будет, ведь можно все прочитать. Сейчас мое мнение изменилось. На это повлияли разные исследования про восприятие информации, собственный опыт создания роликов и общение с теми, кто их смотрит.
Я все еще считаю, что видеоролики стоят дорого, а обновить их быстро не получится. Но если вы можете их сделать, то делайте. Мир меняется, теперь видео есть везде:
- Google
- Яндекс
- Ozon
- Miro

Почему нельзя избавиться от текста

У видео есть недостатки, которые не дают ему полностью заменить текст. Про цену повторяться не буду🤑
Для меня основные это:
- Сложно что-то найти, Ctrl+F не работает, пробежаться глазами тоже не получится. Сейчас на Youtube можно добавить в видео встроенный таймлайн, это помогает, но все равно не поиск.
- Долго смотреть, прочитать можно быстрее. Особенно если вы хотите повторить (перечитать) какой-то момент.
- Нужен быстрый интернет, без ограничений по объему трафика. С этим могут быть проблемы, например, в путешествии.
- А еще нужно не забыть наушники.

#точкароста #самсебережиссер

​​Про контент-стратегию

Контент-стратегия может восприниматься как термин из сферы маркетинга. Общими словами контент-стратегия — это про планирование и создание контента на основе потребностей пользователей, а контентом может быть что угодно (и посты в Instagram, и Readme на Github).

В контент-стратегию включают очень много разных областей:
- документацию, описание ошибок и интерфейсные тексты
- глоссарий (общий для технических писателей, маркетинга, поддержки)
- проверку на доступность контента
- информационную архитектуру
- карты пути клиента и ментальные модели
- опросы и интервью с пользователями
- маркетинговые исследования рынка

Но это не означает, что контент-стратег делает это все один. Он работает вместе с исследователями, дизайнерами, инженерами, менеджерами, собирает разную информацию и анализирует. В итоге, он составляет план действий, где в продукте нужен контент и в каком формате (готовый ответ для бота, страница в помощи, инфографика, виджет или что-то еще).
Здесь самое место для вдохновляющей цитаты Сары Ричардс (Sarah Richards), контент-дизайнера и основателя Content Design London:

Лучшие продукты создаются там, где люди открыты для совместной работы, чтобы найти лучшие решения. (The best products are created where people are open to working together to find the best solutions.)

А что технические писатели?

Контент-стратегия и технические писатели редко упоминаются вместе, а зря. Технические писатели объединяют значительную часть контента по продукту: пишут справку, тексты интерфейса, релиз ноуты и внутреннюю документацию, следят за единой терминологией, помогают с шаблонами ответов для поддержки, снимают видео обучение. И это все относится к контент-стратегии, такая захватывающая у нас, технических писателей, работа.

Что почитать

За один пост я тему не раскрыла, планирую продолжать, а пока вот почитайте:
- Content Design below the surface на Medium. Именно картинку из этой статьи я прикрепила к посту.
- Блог сайта gov.uk.
- Блог Content Design London. Основатель Content Design London Сара Ричардс (Sarah Richards) еще известна тем, что руководила контент-дизайном в gov.uk.

#contentstrategy #точкароста

Менторство

Я начинала свою карьеру как единственный технический писатель в компании. Сама разбиралась, что нужно учить, чтобы расти в карьере. Когда я стала работать в команде, расти стало проще — помогал фидбэк и опыт коллег. Поэтому я считаю, что общение с ментором, который уже прошел похожий путь, сложно заменить. Про то, кто такой ментор, хорошо написано в канале No Flame No Game.

Если вы готовы поделиться с кем-то своим опытом или ищете себе ментора, то вот проекты, где можно это сделать:

- Society for technical communication
Для кого: для технических писателей и специалистов по технической коммуникации.
💸 Бесплатно.

- UX.Coffee.Hours.
Для кого: для UX-специалистов, есть UX-писатели и контент стратеги.
💸 Бесплатно.

- ADPList
Для кого: для дизайнеров, есть UX-писатели и контент стратеги.
💸 Бесплатно.

- UX Writing Hub
Для кого: для UX-писателей, ищут только менторов.
🤑 Бесплатно для менторов, для менти — стоимость включена в обучение в UX-writing academy.

- GetMentor
Для кого: для всех, есть технические писатели.
🤑 От “бесплатно” до “по договоренности”.

- No Flame No Game
Для кого: для всех, есть технические писатели.
💸 Бесплатно.

#точкароста