Das CPSA-A-Modul ADOC – Architektur­dokumentation vermittelt Softwarearchitekt:innen die Fähig­keiten, Software­ar­chi­tek­turen zielge­richtet zu dokumen­tieren, bestehende Dokumen­tation kritisch zu bewerten und diese sinnvoll weiter­zu­ent­wi­ckeln. Teilneh­mende lernen, wesent­liche Aspekte von Software­ar­chi­tek­turen – darunter Entschei­dungen, Struk­turen, Konzepte, Quali­täts­an­for­de­rungen und Sichten – syste­ma­tisch zu beschreiben und adres­sa­ten­ge­recht zu kommu­ni­zieren. Dafür stellt ADOC grund­le­gende Beschrei­bungs- und Notati­ons­mittel sowie geeignete Werkzeuge für die praktische Umsetzung vor.

Mit der neuen Lehrplan­version 2025.1 wurde das Modul inhaltlich aktua­li­siert und an mehreren Stellen präzi­siert. Der Umfang wurde nur leicht erweitert, die Lernziele jedoch deutlich geschärft. Neu aufge­nommen wurden unter anderem der Einsatz von Generative AI, Docs-as-Code sowie zusätz­liche Notati­ons­op­tionen wie C4, ArchiMate und praxisnahe Canvases. Zudem definiert der Lehrplan nun explizit Archi­tektur-Sichten und aktua­li­siert relevante Standards – unter anderem von IEEE 1471 auf ISO/IEC 42010:2022.

Auch didak­tisch wurde nachge­schärft: Die Zeitvor­gaben wurden überar­beitet und trennen nun klar zwischen Unter­richts- und Übungs­an­teilen, während die Gesamt­dauer des Moduls weiterhin 12 Stunden beträgt.

Im Rahmen der Veröf­fent­li­chung teilt Dr. Gernot Starke, einer der Kuratoren des ADOC-Moduls, seine Perspektive auf die Überar­beitung. Laut Starke wurde die Revision sowohl durch praktische Erfah­rungen als auch durch fortlau­fende metho­dische Weiter­ent­wick­lungen motiviert:

„Nach ein paar Jahren Erfahrung finden sich doch in Lehrplänen ein paar Kleinig­keiten, die aufge­räumt werden sollten. Außerdem steht die Entwicklung metho­di­scher Ansätze ja nicht still – dem möchten wir durch das Update Rechnung tragen.“

Besonders wichtig war den Kuratoren dabei, Stabi­lität und Aktua­lität in Einklang zu bringen:

„Wir wollten einer­seits die solide metho­dische Grundlage von ADOC erhalten, anderer­seits aber den Neuerungen der Praxis gerecht werden.“

Für Softwarearchitekt:innen bringt die neue Version vor allem einen prakti­schen Mehrwert:

„Das Modul ist noch prakti­scher und anwend­barer geworden. Entwick­lungs­teams können mit den Inhalten direkt loslegen, eigene Systeme zielge­richtet und passend für verschiedene Stake­holder zu erklären – sowohl schriftlich als auch mündlich.“

Die neue ADOC-Lehrplan­version 2025.1 steht ab sofort zur Verfügung und kann hier herun­ter­ge­laden werden: https://public.isaqb.org/curriculum-adoc/