In vielen Projekten findet Dokumentation in einer ihrer beiden Extremformen statt: Entweder wird fast überhaupt nichts dokumentiert, und damit geht wichtiges Wissen verloren, oder es existiert ein Übermaß an teils schlecht strukturierten Dokumenten, die für die Weitergabe von Wissen denkbar ungeeignet sind.
Gerade von den agilen Verfahren zur Softwareentwicklung können wir lernen, wie eine bedarfsgerechte Dokumentation aussehen kann. So ist es sinnvoll, nur Dokumente zu erstellen, die einen klar erkennbaren Nutzen haben, z.B. für spätere
Projektphasen oder Folgeprojekte. Darüber hinaus ist es wichtig, Dokumentation als eine von mehreren möglichen Formen des Wissensaustauschs im Team zu begreifen. Schließlich hängt die Verwendbarkeit der Dokumentation auch von ihrer Gestaltung ab. Prägnante und gut strukturierte Dokumente bieten eine hohe Lesbarkeit
und einen zielsicheren Zugriff auf das darin enthaltene Wissen.
Dieses Buch vermittelt die Grundlagen und Techniken der Dokumentation in agilen Projekten. Der Autor stellt zahlreiche Lösungsmuster vor und gibt Hinweise, wie eine gute Dokumentation von Softwareprojekten aussehen kann. Der Aufbau des Buches orientiert sich weitgehend am iterativen Vorgehen in agilen Projekten und spiegelt den
Lebenszyklus von Dokumenten in einem agilen Kontext wider. Im Einzelnen werden beschrieben:
- Einstieg in ein agiles Vorgehen
- Infrastruktur und Werkzeuge
- Planung der Dokumentation
- Auswahl der richtigen Inhalte
- Gestaltung einzelner Dokumente
- Umgang mit der Dokumentation
Kurzfassungen der Muster, ein Portfolio möglicher Dokumente und ein Glossar schließen das Buch ab.