Lightweight Architecture Documentation

Training iSAQB® CPSA®-Advanced ADOC

2025-03-24 - 2025-03-25

Technology
Methodology20
Communication

ADOC (Therme Erding) - Stefan Zörner - German

Description

How to document and communicate software architecture?

Create and maintain traceable architecture documentation. Choose targeted formats and tools for an optimal balance of effort and benefit.

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.

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

iSAQB ADOC training

Agenda

  • 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

  • Evaluation of documentation: Review of standard conformity vs. usability

Your Trainers

Stefan Zörner

embarc

Architekturdokumentation, Methodische Softwarearchitektur und Cloud-Anwendungen

  • Architecture Evaluation
  • CPSA Foundation Level
  • Evolution and Improvement of software architectures
  • Flexible architectures
  • Lightweight Architecture Documentation

Von der Bayer AG über IBM und oose zu embarc. Stefan Zörner blickt auf 20 Jahre IT-Erfahrung zurück und stets gespannt nach vorn. Er unterstützt in Architektur- und Umsetzungsfragen mit dem Ziel, gute Architekturansätze wirksam in der Implementierung zu verankern. In lebendigen Workshops vermittelt er Handwerkszeug dazu und steckt mit seiner Begeisterung an. Sein pragmatischer Ansatz Architektur festzuhalten findet großen Anklang.

All info about training