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. Dein agilophiler Frank

Ask this episode

“What did the council decide on item 42?” — answered with the speaker and the moment.

Transcript

Related