Найти в Дзене
codemonsters

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

Митап о первоисточнике истины: как мы меняем подход к документации Провели митап о том, с чего должно начинаться погружение инженера в проект — с единого источника правды о системе. Говорили про Doc as Code — подход, когда документация живёт рядом с кодом и обновляется вместе с ним. Мы меняем устоявшиеся привычки и становимся современным финтехом. На митапе инженеры: - Показывали реальные примеры качественного описания сервисов и спецификаций - Демонстрировали генерацию кода по OpenAPI, Async Api спекам - Рассказывали, как каталог софта (Backstage) упрощает навигацию по ИТ-ландшафту компании Формат изменился — стало меньше абстрактных вопросов и больше практики. Инженеры отвечали на вопросы коллег, показывали живые примеры из своих проектов, на деле демонстрировали, как работают новые подходы. 55 человек оффлайн Онлайн: Уникальные зрители более 700 Всего просмотров 1 322 крутится мысль Сижу в такси после митапа, смотрю в окно и радуюсь. 5 лет назад я недоумевал: почему в корп

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

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

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

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

На митапе инженеры:

- Показывали реальные примеры качественного описания сервисов и спецификаций

- Демонстрировали генерацию кода по OpenAPI, Async Api спекам

- Рассказывали, как каталог софта (Backstage) упрощает навигацию по ИТ-ландшафту компании

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

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

Онлайн:

Уникальные зрители более 700

Всего просмотров 1 322

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

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

5 лет назад я недоумевал: почему в корпоративной культуре не используют практики из open source сообщества? Почему не делают как на GitHub зрелые проекты?

И вот мы внедряем именно такие подходы в Газпромбанке.

Пишем документацию в Git. Больше не нужно блуждать по ресурсам среди устаревших страниц и собирать контекст.

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

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

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

#codemonsterslog

-2