embarc logo
embarc logo

ADOC

Documenting and communicating software architectures - iSAQB Module ADOC (2 days)

All Seminars

Architecture Documentation – Capturing and Communicating Software Architectures.

In this seminar, with a strong hands-on and discussion component, we dust off the classic topic of architecture documentation and bring it into a contemporary form. We show lean structural proposals as a complement to arc42, cover the benefits and pitfalls of Docs-as-Code, and discuss new possibilities in the toolbox made possible by GenAI. 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

Introduction and Motivation
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.

iSAQB Logo ADOC

 
 

Our Extras for You

Photo Log
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).

Softwarearchitekturen dokumentieren und kommunizeren

Did we spark your interest?

Verwenden Sie das Kontaktformular oder senden Sie Stefan Zörner eine E-Mail.