Eine Szene in einem ganz normalen DEV-Team ...
Dokumentation? Die liest doch keiner.
Nur, wenn sie schlecht ist.
Ich mache das lieber im Kopf.
Blöd, dass dein Kopf nicht versioniert ist.
Außerdem reicht der Code als Dokumentation.
Nur für Details – nicht für Zusammenhänge.
Der Quelltext erzählt nicht
die ganze Geschichte
.
- Simon Brown
Prgramatisch dokumentieren
An Zielgruppen orientiert
Nicht zu viel, stets aktuell halten
Modularisieren, referenzieren, generieren
Feedback einholen und einarbeiten
Lebendige Dokumentation
Validierung der Architekturregeln
Explizite Architektur-konzepte im Code
Transparenz durch Dokumentation