Documenting your event-driven architectures with OpenAPI and AsyncAPI

Governance for event-driven architectures is always an after thought. Many companies often end up in a complex mess when building these distributed systems, including the lack of standards, discoverability and ownership.

If we treat schemas as a first class citizen, we can utilize OpenAPI and AsyncAPI to help us document our event-driven architectures and bring discoverability to our teams.

In this talk we will explore how to get the most of our OpenAPI and AsyncAPI specifications, how to document queries, commands, events and even domains. We will also look at how to build a catalog of information for your teams to explore and discover your event-driven architectures.