Спасибо я посмотрю. Пока для себя выделил следующие инструменты:
- DocToolChain
https://doctoolchain.github.io/docToolchain/#_overview_of_available_tasks По идеологии очень близко, правда надо что-то придумать, что бы к коду прикрутить
- Pivio
http://pivio.io/ подходит для ведения каталога и общей информации по мс
- Swagger для генерации описания REST API
- AsyncAPI
https://www.asyncapi.com/ прикольно выглядит для описания асинхронных взаимодействий
- javadoc и asciidoc
Все выше указанное не покрывает все потребности полностью, будем что-то напильником подпиливать