Welcome to the new week!

“How to document systems build with Event-Driven Architecture?”

and

“How to keep our understanding about evolving messages definitions?”

Are one of the common questions I’m being asked. For many years my usual answer was:

"Keep it simple, use Markdown, and make it a part of your design and development process”

Still, that does not scale, and governance requires proper practices and tooling.

That’s why I’m happy that tools like EventCatalog emerged. Well, it didn’t precisely emerge; David Boyne thoroughly built it. He brought not only his passion but to EDA, most importantly, his wide experience.

Over the past few years, David has focused on serverless and event-driven architectures, making both more accessible to everyone through content such as EDA Visuals, speaking, and open source tools. He has also worked in AWS and on the AsynApi initiative. He has lead teams that have built applications scaling to millions of people worldwide.

Now, his main focus is on EventCatalog and helping others to document and operate their Event-Driven systems.

That’s why I’m super happy that he agreed to do a hands-on webinar and show us EventCatalog in practice. And this is a free webinar for all, as I believe it’s essential to spread awareness of it.

What is EventCatalog? It is an open-source documentation tool focused on bringing discoverability to Event-Driven Architectures. EventCatalog is not locked down to any technology, broker or implementation details.

David showed us the ease of use and versatility of extensions, plugins, generators, and multiple schema formats.

I love what he said during the webinar:

The whole idea here is for teams to document their resources. I think this is important because schemas can only go so far, right?

If I were to show you a schema of an order-placed event, we'd be looking at a JSON schema. That's great for engineers and developers, I guess, to an extent.

But the question is, what's the semantic meaning behind all of this? And I think when I said earlier about Domain-Driven Design, you know, as we do things like event storming, we discuss the meaning of the events. We discuss, like, what is this thing?

We talk about naming conventions, and there is conflict in these sessions. There is meaning behind these events.

So why not document them and share that meeting with others so others can discover the event and say, okay, the order placed means this, in this context, means this particular thing.

Oh, great. Fantastic. I can consume that. I know exactly what it is.

Versus, I guess, just guessing

Especially the last sentence is 🌶️

Watch it fully, and tell us how you like it. Feel also invited to add your comments!

We’re also considering moving another one going through the existing sample (for instance, this one made with Emmett) and showing how to add EventCatalog to the existing project.

Cheers!

Oskar

Other Webinars

• #1 - From CRUD to Event Sourcing

• #2 - Keep your streams short! Or how to model Event-Sourced systems efficiently

• #3 - Implementing Distributed Processes

• #4 - From CRUD to CQRS in Practice

• #5 - Architecture Weekly 100 Edition - Live Q&A

• #6 - Alexey Zimarev - You don't need an Event Sourcing framework. Or do you?

• #7 - Design and test Event-Driven projections and read models

• #8 - Slim down your aggregates!

• #9 - Radek Maziarka - Modularization with Event Storming Process Level

• #10 - PostgreSQL Superpowers in Practice

• #11 - Maciej "MJ" Jędrzejewski - Evolutionary Architecture: The What. The Why. The How.

• #12 - Jeremy D. Miller: Simplify your architecture with Wolverine

• #13 - Yves Goeleven - The Fantastic 9

• #14 - Mateusz Jendza - Why Verified Credentials is the Future of Digital Identity!

• #15 - Mário Bittencourt: Leveraging BPMN for Seamless Team Collaboration in Software Development

• #16 - Papers We Love #1 - Sagas (Hector Garcia-Molina, Kenneth Salem)

• #17 - Simple patterns for events schema versioning

• #18 - Andrea Magnorsky: Introducing Bytesize Architecture Sessions!

• #19 - Laïla Bougriâ: Debug your thinking

• #20 - Papers We Love #2 - How do committees invent? (Melvin E. Conway)

• #21 - Michael Drogalis: Building the product on your own terms

• #22 - On Performance Testing with Jarosław Pałka

• #23 - Gojko Adzic on designing product development experiments with Lizard Optimization

• #24 - Frontent Architecture, Backend Architecture or just Architecture? With Tomasz Ducin

• #25 - Applying Observability: From Strategy to Practice with Hazel Weakly

• #26 - React Query: A solution for Frontend State Management challenges? With Tomasz Ducin

• #27 - Documenting Event-Driven Architecture with EventCatalog and David Boyne