Episode 15: Architekturdokumentation

Episode 15 setzt sich mit dem vielerorts ungeliebten Thema Architekturdokumentation auseinander und gibt eine Reihe Best Practices hierfür mit.

SoftwareArchitekTOUR  –  1 Kommentare

Dokumentation ist lästig und überflüssig ...; na ja, nicht wirklich. Architektur dient der Kommunikation und ein Architekturdokument als dessen persistente Ausprägung. Gerade aber nicht nur für Architekturen, die über eine längere Zeit verwendet werden sollen, ist eine brauchbare und trotzdem nicht zu aufwendige Dokumentation essenziell. In dieser Episode gehen die Podcast-Autoren Michael Stal und Markus Völter auf eine Reihe von Best Practices zur Architekturdokumentation ein: Dazu zählen strukturierte Glossare, Patterns, Tutorials und FAQs, Diagramme und Modellierung, einige stilistische Aspekte sowie die Verwendung alternativer Kanäle wie Audio und Video.


Shownote: