))
Wie dokumentiere ich in agilen Projekten?
Manage episode 322012932 series 2656775
Inhalt bereitgestellt von Frank Hampe. Alle Podcast-Inhalte, einschließlich Episoden, Grafiken und Podcast-Beschreibungen, werden direkt von Frank Hampe oder seinem Podcast-Plattformpartner hochgeladen und bereitgestellt. Wenn Sie glauben, dass jemand Ihr urheberrechtlich geschütztes Werk ohne Ihre Erlaubnis nutzt, können Sie dem hier beschriebenen Verfahren folgen https://de.player.fm/legal.
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.
141 Episoden
Teilen
