Softwarearchitekten kennen die wesentlichen Qualitätsmerkmale technischer Dokumentation und können diese bei der Dokumentation von Systemen berücksichtigen bzw. erfüllen:

• Verständlichkeit, Korrektheit, Effizienz, Angemessenheit, Wartbarkeit
• Orientierung von Form, Inhalt und Detailgrad an Zielgruppe der Dokumentation

Sie wissen, dass Verständlichkeit technischer Dokumentation nur von deren Zielgruppen beurteilt werden kann.

Softwarearchitekten:

• können Architekturen stakeholdergerecht dokumentieren und kommunizieren und dadurch unterschiedliche Zielgruppen adressieren, z. B. Management, Entwicklungsteams, QS, andere Softwarearchitekten sowie möglicherweise zusätzliche Stakeholder
• sind in der Lage, die Beiträge unterschiedlicher Autorengruppen stilistisch und inhaltlich zu konsolidieren und harmonisieren
• kennen den Nutzen von Template-basierter Dokumentation.

Softwarearchitekten kennen mindestens folgende UML-Diagramme zur Notation von Architektursichten:

• Klassen-, Paket-, Komponenten- und Kompositionsstrukturdiagramme
• Verteilungsdiagramme
• Sequenz- und Aktivitätsdiagramme
• Zustandsdiagramme

Softwarearchitekten kennen Alternativen zu UML-Diagrammen. Insbesondere für die Laufzeitsicht eignen sich z. B. Flussdiagramme, nummerierte Listen, BPMN.

Softwarearchitekten können folgende Architektursichten anwenden:

• Kontextsicht (auch genannt Kontextabgrenzung)
• Baustein- oder Komponentensicht (Aufbau des Systems aus Softwarebausteinen)
• Laufzeitsicht (dynamische Sicht, Zusammenwirken der Softwarebausteine zur Laufzeit, Zustandsmodelle)
• Verteilungs-/Deploymentsicht (Hardware und technische Infrastruktur sowie Abbildung von Softwarebausteinen auf diese Infrastruktur)

Softwarearchitekten können:

• Kontext von Systemen z.B. in Form von Kontextdiagramm mit Erläuterungen darstellen
• externe Schnittstellen von Systemen in der Kontextabgrenzung darstellen
• fachlichen und technischen Kontext differenzieren.

Softwarearchitekten können typische Querschnittskonzepte (auch genannt Prinzipien oder Aspekte) adäquat dokumentieren und kommunizieren, z. B. Persistenz, Ablaufsteuerung, UI, Verteilung/Integration, Protokollierung.

Softwarearchitekten können sowohl interne als auch externe Schnittstellen beschreiben und spezifizieren.

Softwarearchitekten können:

• Architekturentscheidungen systematisch herbeiführen, begründen, kommunizieren und dokumentieren
• gegenseitige Abhängigkeiten solcher Entscheidungen erkennen, kommunizieren und dokumentieren.

Softwarearchitekten nutzen Dokumentation zur Unterstützung bei Entwurf, Implementierung und Weiterentwicklung (auch genannt Wartung oder Evolution) von Systemen.

Softwarearchitekten kennen:

• Grundlagen mehrerer publizierter Frameworks zur Beschreibung von Softwarearchitekturen, beispielsweise:
• arc42
• C4
• RM/ODP
• FMC
• Ideen und Beispiele von Checklisten für die Erstellung, Dokumentation und Prüfung von Softwarearchitekturen
• mögliche Werkzeuge zur Erstellung und Pflege von Architekturdokumentation