# Documenting Event-Driven Architectures with OpenAPI and AsyncAPI > [! note]- > The content of this page is generated by audio/video transcription and text transformation from the content and links of this source. Source: [https://fosdem.org/2025/schedule/event/fosdem-2025-5144-documenting-your-event-driven-architectures-with-openapi-and-asyncapi/](https://fosdem.org/2025/schedule/event/fosdem-2025-5144-documenting-your-event-driven-architectures-with-openapi-and-asyncapi/) <video src="https://video.fosdem.org/2025/k4201/fosdem-2025-5144-documenting-your-event-driven-architectures-with-openapi-and-asyncapi.av1.webm" controls></video> ## Summary & Highlights: This session at FOSDEM 2025 focuses on the documentation of event-driven architectures using OpenAPI and AsyncAPI. The discussion highlights the importance of treating schemas as first-class citizens to improve discoverability and governance in distributed systems. **Introduction to Event-Driven Architectures** Event-driven architectures are complex systems that require detailed documentation for better governance and discoverability. Many companies struggle with the lack of standards and ownership in these systems. The session emphasizes the need for treating schemas as first-class citizens to address these challenges. **The Role of OpenAPI and AsyncAPI** OpenAPI and AsyncAPI are introduced as tools to document event-driven architectures effectively. OpenAPI has become a standard for building APIs, while AsyncAPI helps document channels, messages, and protocols in event-driven systems. The session explores how these specifications can be used to create a catalog of information for teams. **Challenges in Event-Driven Systems** The session discusses the complexities and challenges of event-driven architectures, such as lack of standards, assumptions, and documentation. It highlights the need for better governance and the role of specifications in managing these complexities. **Event Catalog: A Solution for Documentation** Event Catalog is presented as an open-source tool that helps document event-driven systems. It allows teams to create visual representations of their architectures, enhancing understanding and collaboration. The tool uses OpenAPI and AsyncAPI specifications to fuel documentation and improve governance. **Conclusion and Call to Action** The session concludes with a call to action for participants to engage with the open-source community and contribute to projects like Event Catalog. It emphasizes the importance of documentation in managing the complexity of event-driven architectures and the potential of open-source tools to drive innovation. ## Importance for an eco-social transformation The session is significant for eco-social transformation as it addresses the need for better governance and documentation in complex systems, which can lead to more sustainable and efficient practices. OpenAPI and AsyncAPI can be applied by eco-social designers to create transparent and accessible documentation for community-driven projects. The main challenges include ensuring widespread adoption of standards and overcoming technical complexities. Socially, fostering a community around open-source projects like Event Catalog can enhance collaboration and knowledge sharing. Politically, advocating for open standards can promote inclusivity and democratization of technology. ## Links [EventCatalog](https://eventcatalog.dev) - A tool for documenting event-driven architectures [AsyncAPI Generator for EventCatalog](https://www.asyncapi.com/tools) - Tools for generating AsyncAPI documentation [OpenAPI Generator for EventCatalog](https://openapi-generator.tech) - Tools for generating OpenAPI documentation [Video recording (AV1/WebM)](https://video.fosdem.org/2025/k4201/fosdem-2025-5144-documenting-your-event-driven-architectures-with-openapi-and-asyncapi.av1.webm) - Watch the session in AV1/WebM format [Video recording (MP4)](https://video.fosdem.org/2025/k4201/fosdem-2025-5144-documenting-your-event-driven-architectures-with-openapi-and-asyncapi.av1.mp4) - Watch the session in MP4 format [Video recording subtitle file (VTT)](https://video.fosdem.org/2025/k4201/fosdem-2025-5144-documenting-your-event-driven-architectures-with-openapi-and-asyncapi.vtt) - Subtitle file for the session