arc42

arc42 ist ein Template für Architekturdokumentation. Es stammt von Peter Hruschka und Gernot Starke, die erste Version erschien 2005. Es ist unabhängig von Technologie und Vorgehensmodell und passt gut zu schlanken, agilen Teams. Die Vorlage steht unter CC BY-SA 4.0 und liegt unter anderem als AsciiDoc, Markdown und Word vor.

Die zwölf Abschnitte, hier in drei Gruppen eingeteilt (die Gruppen sind eine Ordnungshilfe, kein Teil von arc42):

• Aufgabe und Rahmen: Einführung und Ziele, Randbedingungen, Kontextabgrenzung.
• Lösung und Sichten: Lösungsstrategie, Bausteinsicht, Laufzeitsicht, Verteilungssicht, Querschnittliche Konzepte.
• Entscheiden und Bewerten: Architekturentscheidungen, Qualitätsanforderungen, Risiken und technische Schulden, Glossar.

Man muss nicht alles ausfüllen. Das Template soll helfen, nichts Wichtiges zu vergessen, und nur so viel Dokumentation verlangen, wie das Team wirklich braucht. Für Qualitätsthemen gibt es das Q42-Qualitätsmodell.

Weiterlesen

• arc42 Overview
• arc42 Dokumentation und Tipps
• arc42 Beispiele
• arc42 FAQ, Fragen zu den Abschnitten
• Lizenz
• Template-Repository (GitHub)