Если вы в очередной раз не смогли найти, как у вас что-то работает, и первой мыслью было «А давайте всё задокументируем!», то Семён Факторович поможет разобраться, какие задачи стоят за этой фразой на самом деле, как уметь эти задачи понимать, между собой различать и выбирать подходящее решение.
⠀
«Хочу всё задокументировать» — нормальное состояние тимлида. Мы все прекрасно понимаем, что хорошая внутренняя документация решает множество проблем команды разработки:
⠀
- структурирует внутренние коммуникации;
- снижает bus factor;
- удешевляет онбординг;
- снижает риски архитектурных ошибок при эволюции проекта.
⠀
Но во фразе «задокументировать всё» оба слова имеют множество смыслов, причем довольно нечетких.
⠀
Что значит «задокументировать»? Какой набор документов мы считаем необходимым и достаточным? Кто и как пишет эти документы?
⠀
Что значит «всё»? Как мы определяем необходимое «документационное покрытие» предметной области проекта?
⠀
В этом докладе мы:
⠀
- поговорим о том, как тимлиду осмыслить и детализировать (в первую очередь для самого себя) задачу по наведению порядка в документации;
- обсудим требования к типовым документам в команде разработки;
- рассмотрим случаи, когда для решения задач тимлида нужен не переполненный информацией Confluence, а всего один-два документа.
⠀
Встречаемся на KnowledgeConf 2023, которая пройдет в рамках TeamLead++ Conf 2023 🖐
⠀
✅ Программа конференции и билеты на сайте в описании канала @KnowledgeConfChannel