arc42 Architecture Documentation
Details
- Vollständiger Name
-
arc42 Architekturdokumentations-Template
Kernkonzepte:
- 12 standardisierte Abschnitte
-
Von Einführung bis Glossar
- Abschnitt 1
-
Einführung und Ziele
- Abschnitt 2
-
Randbedingungen
- Abschnitt 3
-
Kontext und Scope
- Abschnitt 4
-
Lösungsstrategie
- Abschnitt 5
-
Bausteinsicht
- Abschnitt 6
-
Laufzeitsicht
- Abschnitt 7
-
Verteilungssicht
- Abschnitt 8
-
Querschnittliche Konzepte
- Abschnitt 9
-
Architekturentscheidungen
- Abschnitt 10
-
Qualitätsanforderungen
- Abschnitt 11
-
Risiken und technische Schulden
- Abschnitt 12
-
Glossar
- Pragmatische Dokumentation
-
Nur das Notwendige dokumentieren
- Mehrere Formate
-
AsciiDoc, Markdown, Confluence, etc.
- Schlüsselvertreter
-
Gernot Starke, Peter Hruschka
Wann zu verwenden:
-
Mittlere bis große Softwareprojekte
-
Wenn Stakeholder-Kommunikation kritisch ist
-
Langlebige Systeme, die Wartbarkeit erfordern
Aktueller Stand:
-
Die aktuelle Version ist Template-Version 9.0 (Juli 2025); die 12-Kapitel-Struktur ist seit vielen Jahren stabil — die Hauptänderung von v9 teilt Kapitel 10 in eine Qualitätsanforderungs-Übersicht (10.1) und detaillierte Szenarien (10.2)
-
Was sich entwickelt, ist das Material um das Skelett herum: Hilfetexte, Übersetzungen, die Tipps-und-Beispiele-Site docs.arc42.org und das arc42-Qualitätsmodell (Q42) — ein auf v7/v8 trainierter Prior kennt die Kapitelstruktur korrekt, verpasst aber den Kapitel-10-Split und Q42