For decades, documenting software architecture has been a tedious chore. Nobody enjoys it, nobody has time for it, and most documentation ends up outdated or forgotten in a wiki.

That’s about to change. With proven templates like arc42, a docs-as-code approach using Asciidoc, and the support of AI tools, we can finally create living documentation that is relevant, easy to maintain, and—even—fun to write. But let’s be clear: AI will not magically generate the perfect documentation for you. The real challenge is learning how to guide AI so that it produces valuable, trustworthy results.

In this session, we’ll combine these tools in a live demonstration and show step by step how to build and maintain high-quality documentation—complete with diagrams—that evolves alongside your system. Participants will leave with practical techniques, concrete tooling tips, and a clear understanding of how to make AI work for them, so they can start improving their own architecture documentation right away.