Top.Mail.Ru
Ольга Ясинская
Технический писатель в Департаменте управления продуктом Flowwow, Flowwow

Сторителлинг в технической документации: как превратить пользователя в главного героя

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

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

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

Часть 2. Выявление реальных потребностей: как понять, что именно хочет узнать пользователь

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

Часть 3. Сценарный подход: как превратить конфликт в решение

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

Часть 4. Практические инструменты и приёмы для создания “живых” инструкций

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