Как документировать event-driven architecture?

Question

[Иван Шумов]

Многие знают о том что документировать важно и делать это нужно правильно и централизовано. Как это делать с API нам давно рассказал OAS, RAML и иже с ним, но вот что делать с документированием событийной модели? У кого-то решен вопрос документирования событий, генерируемых системами? И если да то какими инструментами?

Comments

[Олег Максименко]

Иван Шумов удалось найти подходящий инструмент?

[Иван Шумов]

Олег Максименко, нет

[Олег Максименко]

Иван Шумов, пока что нагуглилось такое https://www.asyncapi.com/

[Иван Шумов]

Олег Максименко, спасибо. Мы пока выкрутились через https://www.alation.com/, но это энтерпрайзный оверкилл и работает только задним числом(