Architecture Documentation – Capturing and Communicating Software Architectures.
Learn from a recognized expert how documenting architecture turns from a tedious duty into an integral communication and working tool. Learn to capture architecture-relevant influencing factors and central decisions. Experience how a traceable architecture emerges with the support of the right documentation ingredients.Agenda
What goals can you achieve with architecture documentation?
Minimal Architecture Overview
What belongs in it? How do you produce one?
Ingredients of Architecture Documentation
Decisions, concepts, diagrams …
Structures
Benefits of templates, arc42 and alternatives
Approach
Target audiences, selecting components, documenting before vs. after
The Tooling Question
Common options, their strengths and weaknesses, typical challenges
Evaluating Documentation
Checking for standard compliance vs. usability
Your Benefit
As part of this workshop, participants work out selected ingredients of an architecture documentation, present the results to each other, and derive insights under the guidance and feedback of the workshop leader. Where possible, we work on your project during the session.
Target Audience
This workshop is aimed at software developers and architects who design and evolve systems. You already have practical experience in IT projects. Knowledge of a specific technology or programming language is not required. UML knowledge is an advantage, but not a mandatory prerequisite.
iSAQB Accredited
In our seminar, we implement the learning goals of the iSAQB curriculum ADOC in a modern, hands-on and interactive way. On your way to becoming a Certified Professional for Software Architecture (CPSA) Advanced, you receive 20 methodological Credit Points.

Our Extras for You
All exercise results and theoretical content shown are made available to participants electronically afterwards
Official Certificate of Participation
In this seminar, participants are awarded 20 methodological Credit Points for the iSAQB® CPSA-Advanced Level with a perpetually valid iSAQB® certificate.
Additionally ...
This seminar is based on the book „Softwarearchitekturen dokumentieren und kommunizieren – Entwürfe, Entscheidungen und Lösungen nachvollziehbar und wirkungsvoll festhalten“ (German, Hanser Verlag, 3rd edition) by your trainer Stefan Zörner. The book is included in the seminar price for every participant (hardcover edition and eBook).