Как выглядит документация в команде разработки в 2025

Продуктовые решения

Доклад принят в программу конференции

Целевая аудитория

Тимлиды, технические руководители, старшие разработчики

Тезисы

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

– Как выглядят процессы и артефакты документирования в зрелых инженерных командах?
– Почему код — всё еще не лучшая документация?
– Каковы критерии качества и критерии полноты у документации?
– Какие инструменты документирования зарекомендовали себя лучше всех?
– Помогает ли ИИ писать документацию?
– Нужен ли инженерной команде технический писатель?
– Как разработчику найти время на написание документации?

Пять лет писал на C++, а потом добровольно и осознанно стал техническим писателем (да, так бывает!).
С 2012 до 2018 руководил отделом технической документации в Zodiac Interactive.
В 2018 году основал компанию по заказной разработке документации и консалтингу в этой области.

Видео