В современных кросс-функциональных командах документация часто становится источником конфликтов: Wiki с неверифицируемыми диаграммами, Asciidoc и Markdown с рассинхронизированными Swagger-файлами, ручное копирование DTO между фронтом и бэком. Аналитики тратят часы на таблицы в Confluence, которые не живут в Git, а разработчики спорят о трактовке контрактов.
О решении ходят слухи уже давно: подход Docs-as-code всплывает в сознании многих, но не всегда к нему легко подступиться.
На квартирнике попробуем разобраться, как и зачем такой подход внедрять с меньшими потерями, какие новые форматы появились на рынке, кто в итоге отвечает за документацию, если это код, и — самое интересное — как с такой документацией работает AI.
Инструменты и документация, JS / TS
Бэкенд-разработчик, Фронтенд-разработчик, Системный аналитик
Средний
Работает в IT после инженерного прошлого, меняет документацию и подход команды к документированию. Активно продвигает позицию о том, что аналитики тоже должны разрабатывать. В Т-банке занимается системами формирования документации.
Преподаёт в институте. В работе использует преподавательские навыки для коммуникации, а в институте предлагает студентам кусочки корпоративной практики.
Системный аналитик. В Т-банке занимается автоматизацией процессов найма. Специализируется на лечении легаси и задачах высокой неопределенности. Вместе с командой решили проблему дедупликации на нестабильных данных. И реализовали базу кандидатов, соответствующую требованиям 152-ФЗ.
В свободное время решает проблему трассировки эффекта и разбирает конфликт «‘PM vs SDE».