Dokumentation im agilen Kontext
In vielen Projekten findet man eine der beiden Extremformen von Dokumentation vor: entweder wird fast überhaupt nicht dokumentiert und wichtigees Wissen geht verloren oder es entstehen mit großem Aufwand sehr viele Dokumente, in denen sich aber letztlich niemand zurecht findet und die daher nur sehr eingeschränkten Nutzen bieten. Gerade von den agilen Verfahren zur Software-Entwicklung können wir lernen, dass umfangreiche Dokumentation nur selten hilfreich ist. Besonders problematisch ist es, wenn Dokumentation als Entschuldigung für mangelnde Kommunikation im Team herhalten muss.
Bedarfsgerechte Dokumentation
Es ist sinnvoll, die Notwendigkeit einzelner Dokumente kritisch zu prüfen und nur Dokumente zu erstellen, die einen tatsächlichen, klar erkennbaren Nutzen haben, zum Beispiel für spätere Projektphasen oder für Folgeprojekte. Außerdem ist es wichtig, Dokumentation als eine von mehreren Formen des Wissensaustauschs im Team zu begreifen. Dokumentation ergänzt die Diskussion im Team, ersetzt sie aber natürlich nicht. Schließlich hängt der Nutzen der Dokumentation auch von ihrer Form ab. Prägnante und gut strukturierte Dokumente bieten eine hohe Lesbarkeit und einen schnellen und zielsicheren Zugriff auf das darin enthaltene Wissen.
Ich biete Projekten und Organisationen Unterstützung für die Konzeption und Entwicklung einer bedarfsgerechten Dokumentation.
Buch
|
Basierend auf meiner Erfahrung mit der Dokumentation in einer Vielzahl von Projekten habe ich ein Buch geschrieben, das 50 Patterns darüber enthält, wie gute Dokumentation von Software-Projekten aussehen kann: Agile Documentation - Das Buch ist erschienen bei John Wiley & Sons (2003). Die Themen sind: 1. Umfang der Dokumentation 2. Struktur einzelner Dokumente 3. Layout und Typographie 4. Technische Organisation 5. Planung und Qualitätssicherung |
|
|
Copyright Andreas Rüping, 2006. Trotz sorgfältiger Prüfung der über einen Link erreichbaren externen Seiten kann ich für deren Inhalte keine Verantwortung übernehmen. Für den Inhalt externer Seiten sind ausschließlich deren Betreiber verantwortlich.
Impressum: Dr. Andreas Rüping, Sodenkamp 21 A, 22337 Hamburg, Steuernummer 26/225/34412 (Finanzamt Hamburg-Nord)