«Хочу всё задокументировать» — нормальное состояние тимлида. Мы все прекрасно понимаем, что хорошая внутренняя документация решает множество проблем команды разработки:
* структурирует внутренние коммуникации;
* снижает bus factor;
* удешевляет онбординг;
* снижает риски архитектурных ошибок при эволюции проекта.
Но во фразе «задокументировать всё» оба слова имеют множество смыслов, причем довольно нечетких.
Что значит «задокументировать»? Какой набор документов мы считаем необходимым и достаточным? Кто и как пишет эти документы?
Что значит «всё»? Как мы определяем необходимое «документационное покрытие» предметной области проекта?
В этом докладе мы:
* поговорим о том, как тимлиду осмыслить и детализировать (в первую очередь для самого себя) задачу по наведению порядка в документации;
* обсудим требования к типовым документам в команде разработки;
* рассмотрим случаи, когда для решения задач тимлида нужен не переполненный информацией Confluence, а всего один-два документа.