Learn how to maintain control as a software architect in the age of coding agents.
🔎 Discover our new training: Architecture in the Context of Agentic Development.
iSAQB® Training

Lightweight Architecture Documentation

iSAQB® CPSA-A® ADOC

0
Technology
20
Methodology
0
Communication
Basics
2 days
12
Seats
German and English
Online and in-person
From
2026-12-14

96%

CPSA-F® exam pass rate

iSAQB® light logo

Also available as in-house training

We run this training exclusively for your team, online or on site.
In-house Offerings

Create and maintain clear and comprehensive architecture documentation. Choose appropriate formats and tools—from arc42 to GenAI—to achieve an optimal balance between effort and benefit.

Objectives

  • Explain goals and benefits of architecture documentation
  • Determine scope, structure and approach according to the situation
  • Learn the standard notation and presentation tools
  • Appropriately document influencing factors
  • Produce meaningful representations
  • Document decisions transparently
  • Select tools and formats according to requirements
  • Give feedback on documentation results
  • Identify use cases for GenAI in the creation, maintenance, and use of documentation
  • Using GenAI Tools in a Targeted Manner and Validating Their Results

Curriculum

  • Introduction and motivation: Which goals do you pursue with architecture documentation?
  • Minimal architecture overview: What should be included? How is it produced?
  • Ingredients of architecture documentation: decisions, concepts, diagrams …
  • Structure: advantage of templates, arc42, and alternatives
  • Process: target groups, selection of the components, documentation before vs. after
  • Tool selection: popular options, their strengths and weaknesses, typical challenges
  • GenAI in Documentation: Practical Use Cases, Tool Support, and Validating Results
  • Evaluation of documentation: Review of standard conformity vs. usability

Audience

This workshop is aimed at anyone who designs and develops software solutions, or who is significantly involved in their creation, for example in the role of product owner. The participants already have practical experience in IT projects. Knowledge of a specific technology or programming language is not required. Knowledge of UML is helpful but not essential. You don’t need to have any prior experience with AI tools.

Description

Documentation as ballast? Effective documenting of the architecture helps you in the design of the software, manages the implementation and results in an understandable and assessable solution. Appropriate documentation supports interaction within the team and vis-à-vis third parties. In this interactive workshop you will learn how the documentation of the architecture changes from a burdensome duty to an integral communication and work tool. Learn to concisely document architecture-relevant influencing factors and important decisions.

‍

We’ll also take a look at generative AI: Where do GenAI tools provide real added value in creating, maintaining, and using architecture documentation—for example, when generating documentation from source code or answering questions about existing documentation? And where should we exercise caution? The training follows the current iSAQB curriculum (2025.1), which incorporates the use of GenAI in architecture documentation as a learning objective.

‍

The basis for the seminar is the book “Softwarearchitekturen dokumentieren und kommunizieren - Entwürfe, Entscheidungen und Lösungen nachvollziehbar und wirkungsvoll festhalten” (Hanser Verlag, 3rd edition) by our trainer Stefan Zörner. The book is included in the seminar price for each participant (hardback and eBook).

‍

Design your training path

try module kit

About iSAQB®

The International Software Architecture Qualification Board (iSAQB®) brings together leading experts from industry, consulting companies, and science. This includes many people of distinction in the world of software architecture. And all with one goal: competent education and further training – internationally recognized, standardized, certified, and always up to date. We are proud that many of us as curators in iSAQB® have jointly masterminded the curricula and examination tasks.

What our customers say

The workshop was a lot of fun for the participants and we were able to take away some topics, especially from the second half. It was also nice to see that we are already doing and living some things right. Personally, I'm particularly pleased about this because the correct handling of technical debt is an important topic for me as a CIO, especially when it comes to long-lasting systems.

Martin Helmich

Head of Architecture & Developer Relations @ mittwald

Trainers

Stefan Zörner

Founder and CEO of embarc

Main Skills

Architecture documentation, methodical software architecture and cloud applications

Benjamin Wolf

Senior Consultant at INNOQ

Main Skills

Architecture documentation, software quality, software development process

More on this topic

Documenting and communicating software architectures

Record designs, decisions, and solutions in a comprehensible and effective manner. Stefan Zörner's book shows you how to record the central solution approaches of your software systems in such a way that they help you with development and further development.

Stefan Zörner

Using Documentation-as-Code (Architecture Spicker No. 15)

Using the same tools and processes as in software development enables you to maintain documentation efficiently. This Spicker explains the idea and helps you to document your projects.

Falk Sippach
Stefan Zörner

The Architecture Overview (architecture cheat sheet No. 1)

You or your team are missing a compact overview of your existing software solution? You want to explain your architecture to new project members or cooperation partners? The source code is too »detailed« … The first edition of our Architecture cheat sheets supports you to get a high-level-overview of solution approaches in order to work effectively. Use the compact ingredients and fill your architecture overview with life – pragmatically and effectively.

Documenting software architectures pragmatically

A compact introduction to arc42. Effective, painless, and with little effort. Gernot Starke and Benjamin Wolf dispel some preconceptions about (technical) documentation and show you how to easily create sensible (architecture) documentation.

Dr. Gernot Starke
Benjamin Wolf

arc42 by Example

The architecture of six real-world software systems, each described using arc42. This allows you to see, through practical examples, what arc42 feels like. Often used to support the introduction of arc42 in teams or projects.

Stefan Zörner
Dr. Gernot Starke

Online Courses

On-site Courses

In-house Training

You can also book this training as an in-house training course exclusively for your team. Please use the enquiry form for more details.

Enquire now

You may also like

socreatory training

Documentation-as-Code

Basics
Advanved
2 Days
12
seats
German and English
Online and In-person
Custom Quote
Workshop

Intensive Preparation for the iSAQB CPSA-A Exam

Basics
Advanved
1 Day
12
seats
German
Online and In-person
from 600.00 €

Frequently Asked Questions

What is the maximum number of participants in a training session?

For most training sessions, we limit the maximum number of participants to 12 per instructor. This allows us to ensure that you receive the best possible guidance.

Are meals provided during in-person training sessions?

Of course, we’ll take care of your meals during our in-person training sessions. We usually provide snacks twice a day and lunch. Drinks are also available.

Where can I find information about the training session I've already booked?

You can find all the information about your training in our socreatory Navigator. Here, in addition to useful links and information, you’ll find the specific location of the training for in-person sessions and the link to the video call for online sessions.

When and how will I receive my certificate of attendance after the training?

If you have attended at least 75% of the sessions, you will receive a certificate of attendance from us. You can download it from our socreatory Navigator a few days after the training.

Why socreatory?

Beyond the expertise of our trainers and our wide range of training courses, we offer even more compelling reasons to train with us.

All the benefits at your fingertips – download our program overview!

Unique Variety

We offer you the most comprehensive training program for software architecture in the German-speaking region – accredited and certified by iSAQB®.

Powerful IT expertise

Our experienced trainers are renowned experts in the industry and have co-developed 80 percent of the module curricula, both in terms of content and teaching methodology.

Hands-on learning experience

We are committed to providing interactive and engaging learning experiences, ensuring all participants can directly apply what they've learned.

Fair pricing model

The total price is reduced for as few as two participants from your company. Furthermore, you benefit from early bird pricing and enhanced planning certainty.

Looking for team training?

Unlock your team's potential with our specialized software architecture courses. We offer a variety of options, from in-depth iSAQB® training to customized workshops tailored precisely to your company's needs. Discover how these training programs can enhance your team's skills, and take advantage of attractive group and package discounts to maximize the value of your investment.