Комментарии 5
А чем mermaid в gitlab не устроил?
Для клиентов в процессе документирования делаю схемы по архитектуре в нем, теже картинки вид сбоку, интегрирован в gitlab, документацию по архитектуре можно сразу линковать с соответствующими репами компонентов с детализацией уже в них.
https://mermaid-js.github.io/mermaid-live-editor/
отдельно редактор для упрощения
там же дока
Я бы не сказал, что он не устроил. Дело в том, что PlantUML в Сбере знаком. Работа.ру часть Сбера. И у него есть значимые преимущества генерации SVG. Генерируемый код от PlantUML лучше поддается постобработке. В какой-то степени это "ставка на красное". Но mermaid со счетов не сбрасывается. Он вполне может расширить языковой ансамбль.
Линковка это не все, что делает DocHub. Одна из ключевых фич - собственный язык описания архитектурных объектов через манифесты. Такая парадигма позволяет работать с архитектурой как с большим JSON. Генерировать на основании него схемы с различными фильтрами. В этом помогает JSONata.
Это же позволяет вставлять в markdown документы "живые" схемы. Т.е. кликабельные и связные. Читатель может проваливаться по ссылкам на любой уровень детализации.
Инструмент который решает конкретную проблему, однозначно решение годное и перспективное!
Упростить бы workflow процесса для людей которые только познают проектирование системы, допустим ещё на своих пет-проектах. Как результат - увеличили бы аудиторию и покрытие, а в будущем эти же бы юзеры столкнулись с проблемами которые как раз таки и решаются с помощью вашего приложения и никуда не нужно было бы идти (уже на месте всё)!
Спасибо, полезное
Архитектура как кот VS Архитектура как кол