Есть 4 варианта :
- руками в конфлю. Так себе но сойдёт.
- руками в gitlab. Там есть спец плагины, которые рендерят html из MD и пикчи из plantuml.
- грэдлом на сервер рядом с приложением. Это вкусно, но обычно всем лень. Больше всего зайдёт жавистам: gradle умеет собирать и MD и asciidoc спеки рекурсивным обходом заданных каталогов. В итоге - страшненькая но очень полная спека на сервис / компоненту.
Примерчик
https://github.com/spring-projects/spring-security/tree/master/docs/manual/src/docs/asciidoc/_includes/servlet/oauth2 там в каталогах есть и диаграммы.
- вообще в отдельном фреймворке с деплоем на отдельный сервачок.
Antora.org на вход берет adoc и puml на выходе сайтик, напоминающий readthedocs.
Но имхо: это не архитектурный туллинг, аналитический. Либо сам все поднимаешь, делаешь шаблоны, фикстуры и "главные диаграммы" и кидаешь в аналитиков с наставлением "все дальше самостоятельно". Самому все это вести от и до - слишком много присяданий потребуется. И в результате остановишься на страничке в конфлюенсе) Проходил :(