Doc as code: опыт Альфа-банка

Интересная и емкая статья про Doc as code от Альфа банка, ребята поделили доку на три слоя - Фронт и Бэк (со своими пользовательскими интерфейсами) и Мидл (читай API), для которого картинки не нужны. Мидл хранят в гите и форматируют через Asciidoc и PlantUML, собирают в автоматизированном пайплайне. В принципе фронт и бэк можно хранить так же, но ребятам важны формы интерфейсов (я бы хранил просто ссылки на условную Фигму). Но в целом ребята так и сделали и хранят в отдельной Git LFS репе. Подробности тут: https://habr.com/ru/company/alfa/blog/680556/ #article