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

Документация на API вроде бы есть, но разработчики всё равно приходят с вопросами о том, как им пользоваться. Корпоративный Confluence — хаотичное хранилище разношерстной информации, в котором непонятно, как искать. Заметки об архитектурных решениях в продукте хранятся в гугл-доках, которые ровным слоем рассредоточены по личным GDrive разработчиков. Пользовательская документация в последний раз обновлялась при Медведеве, и её все равно никто не читает.

Если у вас всё не так — вы молодцы! Если у вас всё именно так, то не расстраивайтесь: это системные проблемы, встречающиеся в очень большом количестве компаний.

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