О видео Docs as Code
Несмотря на то, что мне особо интересно рассказывать о технических моментах, в этот раз я смог серьезно погрузиться в тему и получить от этого удовольствие (кроме видео по кафке, кафка - отстой).
В бытность работы в банки.ру мы реально применяли подход «дока как код», описывали в asciidoc, схемы в puml, апи в сваггере. Локально пишешь это добро, дальше пушишь, да и все, работа закончена.
Просто повторить все это на видео - скучно, поэтому пошел немного в сторону и накрутил CI/CD. Линтеры при создании пр, и сборку сайта после мр. Как и говорил в видео, вряд ли вы на рядовом сисане будете делать подобное, но, когда выходишь за компетенции своей роли, сильно расширяешь кругозор.
Например, изначально текст в видео должен был быть в формате ascii, но я полез в такие дебри со сборкой этого всего в сайт, что просто плюнул и переключился на md.
При это прекрасно понимаю, что аналитиков может бесить docs as code, поскольку простые действие (вроде таблиц) делаются иначе и по-началу медленнее. Но, была бы моя воля, я бы всегда работал только так.
Кто уже посмотрел видос, как вам?
Несмотря на то, что мне особо интересно рассказывать о технических моментах, в этот раз я смог серьезно погрузиться в тему и получить от этого удовольствие (кроме видео по кафке, кафка - отстой).
В бытность работы в банки.ру мы реально применяли подход «дока как код», описывали в asciidoc, схемы в puml, апи в сваггере. Локально пишешь это добро, дальше пушишь, да и все, работа закончена.
Просто повторить все это на видео - скучно, поэтому пошел немного в сторону и накрутил CI/CD. Линтеры при создании пр, и сборку сайта после мр. Как и говорил в видео, вряд ли вы на рядовом сисане будете делать подобное, но, когда выходишь за компетенции своей роли, сильно расширяешь кругозор.
Например, изначально текст в видео должен был быть в формате ascii, но я полез в такие дебри со сборкой этого всего в сайт, что просто плюнул и переключился на md.
При это прекрасно понимаю, что аналитиков может бесить docs as code, поскольку простые действие (вроде таблиц) делаются иначе и по-началу медленнее. Но, была бы моя воля, я бы всегда работал только так.
Кто уже посмотрел видос, как вам?