Dokumentation in agilen Projekten
Selten bin ich über ein Buch zu diesem Thema gestolpert – und habe mit diesem gleich ein gutes erwischt. Das Buch ist selbst recht „leichtgewichtig“, rund 160 Seiten. Es ist so geschrieben, dass man merkt, da versteht einer sein Schreibhandwerk.
Agile Dokumentation ist kein Hexenwerk. Es gibt hier hilfreiche Anregungen und Empfehlungen auf Basis praktischer Erfahrungen. Das alles aufgebaut als Lösungsmuster. Die Kurzfassungen der einzelnen Lösungsmuster – frei nach Design Patterns – am Ende des Buches liefern dann noch einen kompakten Überblick.
Die Darstellung und Aufbereitung als Muster (Patterns) hebt hervor, dass alle Empfehlungen als Anregung verstanden sein sollen, nicht als absolut Vorgegebenes. Hier wird kein Königsweg verkauft. Auch hier, wie bei andern Aspekten der agilen Softwareentwicklung: Die Verantwortung liegt beim Team und der Prozess darf und muss aufs Projekt zugeschnitten sein. Solange die erforderliche Disziplin aufgebracht wird, sich nicht aus Bequemlichkeit von unangenehmen, aber notwendigen Werkzeugen zu trennen.
Im Abschnitt „klare Strukturen“ gibt es ein eingängiges Beispiel, das sofort anwendbar ist. Hervorragend anschaulich :-)
Fazit: Lohnenswert
Themen
- Agile Entwicklung und Dokumentation
- Zielgruppen der Dokumentationsdokumente
- Relevantes Wissen
- Skalierung
- Infrastruktur und Werkzeuge
- Planen der Dokumentation – inkrementell und iterativ
- Inhalte auswählen
- Strukturierung einzelner Dokumente
- Diagramme
- Tabellen
- Verknüpfen
- Lesefreundlichkeit und Layout
- Umgang mit der Doku
- Wissensmanagement
- Bedarfsgerechte Doku
Andreas Rüping: „Dokumentation in agilen Projekten. Lösungsmuster für ein bedarfsgerechtes Vorgehen“. dpunkt 2013. 34,90 EUR (D) / 35,90 EUR (A). ISBN 978-3-86490-040-2 .
Maria