Architecture Communication Canvas: Architektur kompakt
Architekturdokumentation muss nicht aufwendig und schwer zu pflegen sein. Es geht auch kompakt mit einem Steckbrief der Architektur, einem Canvas.
Die Aufgabe der Architekturdokumentation ist es, Fragen der wesentlichen Stakeholder zum Aufbau des Systems zu beantworten, zur Technologie und den großen Entscheidungen (ein Artikel dazu sowie weitere Quellen finden sich unter ix.de/zek2). Dabei geht es primär um die Strukturen und Technologien. Zu den Strukturen gehören der Aufbau des Systems aus Subsystemen, Modulen, Komponenten, Services und deren Abhängigkeiten, außerdem Infrastruktur und Hardware des Systems sowie externe Schnittstellen. Bei den Technologien geht es um eingesetzte Sprachen, Bibliotheken, Frameworks oder Produkte von Drittherstellern. Weitere wichtige übergreifende Entscheidungen und Konzepte betreffen zum Beispiel Test-, Build- und Deployment-Prozesse.
Diese Dokumentation ist wichtig, da der Sourcecode viele Informationen nicht preisgibt (siehe Kasten „Was Quellcode verschweigt“). Auch können zumindest heutige Tools die relevanten Informationen nicht automatisiert herausfinden.
