Wie dokumentiere ich in agilen Projekten?

Es geht heute um die andere Seite des agilen Manifests:
Dokumentation in agilen Projekten.


Im agilen Manifest heißt es:


„Funktionierende Software mehr als umfassende
Dokumentation“


Da steht nicht


„Dokumentation brauchen wir nicht, denn wir arbeiten ja
agil“


Kommunikation ist oft seltsam und ein Empfänger der Botschaft
entscheidet, wie er sie versteht. Aber ich kenne das aus
meiner Projektvergangenheit auch...dieses digitale Denken, dass
ein "sowohl als auch" ausschließt und immer nur das "entweder
oder" versteht. 


Natürlich brauchen wir Dokumentation - und im Agilen Manifest
steht es auch, dass wir Doku brauchen. Nur die Frage ist - wie
immer - Wer braucht Dokumentation wozu?


Wie kann die Antwort lauten?


"Als DevOps Team brauche ich eine Dokumentation, damit ich
schneller den Fehler finde und beheben kann."


aber es geht auch ganz anders:


"Als Kunde möchte eine einfach geschriebene und leicht
verständliche Anleitung zum Produkt, so dass ich schnell damit
arbeiten kann“


Die Doku muss also einen Nutzen bringen - und kann zu diesem
Zweck auch unterschiedlich ausfallen. Am besten ist allerdings
die Doku, die gar nicht benötigt wird, weil das Produkt so gut
designed ist, dass alles von vorne herein klar ist. Die
schlechteste Doku ist die, die nötig ist, aber nicht vorhanden
ist. Alles andere liegt irgendwo dazwischen.


www.frankhampe.com