Was ist arc42?
arc42, entwickelt von Peter Hruschka und Gernot Starke, gliedert Architekturdokumentation in zwölf Abschnitte: Einführung und Ziele, Randbedingungen, Kontextabgrenzung, Lösungsstrategie, Bausteinsicht, Laufzeitsicht, Verteilungssicht, Querschnittliche Konzepte, Architekturentscheidungen, Qualitätsanforderungen, Risiken und technische Schulden sowie Glossar. Es schreibt keine Diagrammnotation vor, deshalb zeichnen Teams darin oft C4-Diagramme: das Kontextdiagramm in Abschnitt 3, Container- und Komponentendiagramme in der Bausteinsicht (Abschnitt 5) und dynamische Diagramme in der Laufzeitsicht (Abschnitt 6). Die eigene Empfehlung von arc42 lautet, nur das zu dokumentieren, was die Leser brauchen, statt jeden Abschnitt auszufüllen.
Auch bekannt als: arc42 template.
Verwandte Begriffe
- C4-Modell — Ein leichtgewichtiger Ansatz zur Architekturvisualisierung, der Softwaresysteme auf vier Ebenen beschreibt: System Context, Container, Component und Code.
- Architecture Decision Record (ADR) — Ein kurzes Dokument, das eine einzelne architektonisch bedeutsame Entscheidung, ihren Kontext und ihre Konsequenzen festhält.
- Living Documentation — Dokumentation, die aus dem laufenden System generiert oder validiert wird, sodass sie genau bleibt, während sich das System weiterentwickelt.