Es gibt zahlreiche Gründe eine Software-Architektur zu dokumentieren, beispielsweise zur Wissensvermittlung innerhalb eines Teams oder für externe Partner; als Bestandteil eines Vertrages oder einfach als Hilfsmittel, um komplexe Strukturen aufzubereiten.

Die Vorgehensweise ist dabei alles andere als trivial, da sich Software von Natur aus nur schwer beschreiben lässt: Es gibt keine eindeutige Sichtweise - es gibt keine Möglichkeit eine Software vollständig in einem Bild grafisch darzustellen. Eine Zeichnung, wie sie Architekten für Häuser anfertigen, gibt es daher in dieser Form nicht.

Aus diesem Grund gibt es nur die Möglichkeit, die unterschiedlichen Sichten auf eine Software einzeln zu beschreiben. Beispielsweise aus der Sicht des Deployments, der Kommunikation der Module untereinander, die Organisation des Quellcodes und so weiter.

Das die Dokumentation nur entlang verschiedener Sichtweisen möglich ist, darüber ist man sich weitgehend einig. Deutlich umstrittener ist jedoch die Frage, welche Sichten in welcher Tiefe nötig sind.

Einen guten Einstieg in die Thematik bietet das Carnegie Mellon Software Engineering Institute (SEI), das vor allem auf das 4+1 Sichten-Vorgehen von Philippe Kruchten verweist:

http://www.sei.cmu.edu/architecture/arch_doc.html

http://philippe.kruchten.com

Unter dem Begriff Patterns & Practices hat Microsoft so genannte Application Blocks (im Quellcode vorliegende "Mini-Frameworks") veröffentlicht, mit denen Standardaufgaben vereinfacht werden. Im Januar 2005 hat man diese erstmals in einer gemeinsamen Bibliothek zusammengefasst und einen Editor zum Anpassen der Konfigurationsdateien beigefügt. Die Bibliothek umfasst folgende Application Blocks:

• Caching Application Block. Dieser Block ermöglicht Entwicklern eigene Cache-Mechanismen zu implementieren
• Configuration Application Block. Mit diesem Block lassen sich auf einfache Weise Konfigurationsdaten verwalten
• Data Access Application Block. Dieser Block bietet eine Kapselung für den Zugriff auf Datenbanken.
• Cryptography Application Block. Auch wenn das .NET Framework bereits ein Set an Klassen bereitstellt, ist die "Bedienunug" nicht immer einfacher. Dieser Block bietet ein High-Level API für Datenverschlüsselung und Hashing
• Exception Handling Application Block. Dieser Block stellt die notwendigen Routinen für eine konsistente Fehlerbehandlung innerhalb der gesamten Anwendung zur Verfügung.
• Logging and Instrumentation Application Block. Mit diesem Block können Entwickler standard Logging- und Instrumentation-Aufgaben realisieren. - Auch in Kombination mit dem Exception Handling Block interessant!
• Security Application Block. Spätestens bei diesem Block kann man nicht mehr von Mini-Frameworks sprechen, denn er ermöglicht Entwickler umfassende Authentifizierungs- und Authorisierungsimplementierungen mit "wenigen Handgriffen" zu erledigen.

Die gesamte Bibliothek ist im Microsoft Download Center erhältlich.