Митап о первоисточнике истины: как мы меняем подход к документации

Провели митап о том, с чего должно начинаться погружение инженера в проект — с единого источника правды о системе.

Говорили про Doc as Code — подход, когда документация живёт рядом с кодом и обновляется вместе с ним.

Мы меняем устоявшиеся привычки и становимся современным финтехом.

На митапе инженеры:
- Показывали реальные примеры качественного описания сервисов и спецификаций
- Демонстрировали генерацию кода по OpenAPI, Async Api спекам
- Рассказывали, как каталог софта (Backstage) упрощает навигацию по ИТ-ландшафту компании

Формат изменился — стало меньше абстрактных вопросов и больше практики. Инженеры отвечали на вопросы коллег, показывали живые примеры из своих проектов, на деле демонстрировали, как работают новые подходы.

55 человек оффлайн

Онлайн:
Уникальные зрители более 700
Всего просмотров 1 322

крутится мысль

Сижу в такси после митапа, смотрю в окно и радуюсь.

5 лет назад я недоумевал: почему в корпоративной культуре не используют практики из open source сообщества? Почему не делают как на GitHub зрелые проекты?
И вот мы внедряем именно такие подходы в Газпромбанке.
Пишем документацию в Git. Больше не нужно блуждать по ресурсам среди устаревших страниц и собирать контекст.

Не нужно придумывать велосипеды — лучшие практики уже отработаны сообществом.

Если тебе интересно следить за трансформацией ИТ в ГПБ — подписывайся на наш Telegram-канал.

P.S. Мне очень нравится этот бульдоня. Розовый ему определённо идёт. Стиль.

#codemonsterslog