Top.Mail.Ru

Документация как приложение: как аналитик становится разработчиком, используя TypeSpec

Квартирники
Архитектура и анализ
Управление командами

Тезисы

В современных кросс-функциональных командах документация часто становится источником конфликтов: Wiki с неверифицируемыми диаграммами, Asciidoc и Markdown с рассинхронизированными Swagger-файлами, ручное копирование DTO между фронтом и бэком. Аналитики тратят часы на таблицы в Confluence, которые не живут в Git, а разработчики спорят о трактовке контрактов.

О решении ходят слухи уже давно: подход Docs-as-code всплывает в сознании многих, но не всегда к нему легко подступиться.

На квартирнике попробуем разобраться, как и зачем такой подход внедрять с меньшими потерями, какие новые форматы появились на рынке, кто в итоге отвечает за документацию, если это код, и — самое интересное — как с такой документацией работает AI.


Ключевые темы и технологии

Инструменты и документация, JS / TS


Аудитория

Бэкенд-разработчик, Фронтенд-разработчик, Системный аналитик


Уровень сложности

Средний

Т-Банк
Андрей Любарский

Работает в IT после инженерного прошлого, меняет документацию и подход команды к документированию. Активно продвигает позицию о том, что аналитики тоже должны разрабатывать. В Т-банке занимается системами формирования документации.

Преподаёт в институте. В работе использует преподавательские навыки для коммуникации, а в институте предлагает студентам кусочки корпоративной практики.

Т-Банк
Роман Говоров

Системный аналитик. В Т-банке занимается автоматизацией процессов найма. Специализируется на лечении легаси и задачах высокой неопределенности. Вместе с командой решили проблему дедупликации на нестабильных данных. И реализовали базу кандидатов, соответствующую требованиям 152-ФЗ.

В свободное время решает проблему трассировки эффекта и разбирает конфликт «‘PM vs SDE».

Другие спикеры Квартирники