Diese Wissensbausteine beschreiben und diskutieren die wichtigsten Möglichkeiten, die Architektur von Softwaresystemen zu beschreiben. Sie illustrieren dies mit Beispielen für Diagramme und für Dokumenttypen.
Architekturdokumente Das Dokument ist immernoch das wichtigste Instrument zur Dokumentation einer Architektur. Typische Dokumenttypen wie das Rationale oder das DV-Konzept werden vorgestellt und mit Beispielen illustriert.
Beschreibungstechniken für Softwarearchitekturen Typsiche Beschreibungstechniken für Softwarearchitekturen angegangen bei informellen Notationen und natürlicher Sprache bis hin zu formalen Notationen werden vorgestellt und diskutiert.
Einsatsbereiche der Architekturdokumentation Die Einsatzbereiche von Softwarearchitekturen und der damit verbundene Nutzen werden dargestellt. Die Einsatzbereiche und die Stakeholder des oder der Systeme hängen eng zusammen.
Gegenstand der Architekturdokumentation Die Softwarearchitektur eines Systems oder einer Menge ähnlicher Systeme kann auf unterschiedliche Arten konkret oder abstrakt dargestellt werden. Drei mögliche Ebenen der Darstellung, von der Architekturvision bis hin zu einer konkreten Anleitung, werden vorgestellt.
Die Dokumentation von Softwarearchitekturen erfordert zusätzliche Aufwände. Für jedes Projekt ist jeweils neu zu entscheiden, ob und in welchem Umfang es sich lohnt, die Architektur zu dokumentieren. Dies wird diskutiert.
Beispiele für Softwarearchitektur-Beschreibungen Einige typische Beispiele für Architekturdiagramme sollen illustrieren, wie Softwarearchitekturen grafisch und ggf. über entsprechende Modelle dokumentiert werden können. Die Beispiele sollen als Anregung dienen.