Александра Тукиш

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

План:

"Книжный" формат пользовательской доки: кажется, он устарел.

Структура справки: как делали проще.

Стиль и язык изложения: как делали легче.

Люди: как адаптировали к быстрым и постоянным изменениям.

Опыт: как замапить успешный опыт на остальные продукты.