Eine Fallstudie zur Verbesserung der Dokumentation in Softwareentwicklungsteams durch Minimaldokumentation

worked on by: Cedric Ressler

1. Einleitung

Dokumentation in Softwareentwicklungsteams bringt einige Herrausforderungen mit sich. Gerade in agilen Teams kann es schwer sein, die Dokumentation auf dem neusten Stand zu halten oder generell Dokumentation für die Software zu produzieren. Das Konzept der Minimaldokumentation könnte ein Ansatz sein, um mit diesen Problemen umzugehen. Minimaldokumentation (auch "Just Enough Documentation", "Lean Documentation" genannt) probiert das Paretoprinzip (80-zu-20-Regel) auf Dokumentation anzuwenden. Das heißt, es soll mit möglichst wenig Aufwand möglichst viel Nutzen generiert werden. Diese Arbeit probiert die Frage zu beantworten, wie Minimaldokumentation dabei helfen kann, die Dokumentation in Softwareentwicklungsteams zu verbessern.

2. Methodik

Aus der Hauptfrage wurden vier Fragen abgeleitet, die dabei helfen sollen, erstere zu beantworten:

1. Welche Probleme gibt es in Softwareentwicklungsteams bezüglich Dokumentation?
2. Wie wirkt sich die Kultur in den Teams auf die Entstehung, Instandhaltung und Nutzung von Dokumentation aus?
3. Wie kann Minimaldokumentation die bestehenden Probleme bezüglich Dokumentation reduzieren?
4. Was muss gegeben sein, um Minimaldokumentation nachhaltig zu implementieren?

Um diese Fragen zu beantworten wird eine Fallstudie in einem deutschen Unternehmen durchgeführt. Dafür wurden fünf Unterschiedliche Teams identifiziert und es wurde jeweils einem Entwickler pro Team interviewt. Diese Interviews (aus zeitlichen Gründen eine reduzierte Anzahl) werden anhand der Thematischen Analyse (Braun/Clarke, 2006, 2013) ausgewertet. Dadurch soll die erste Frage nach den Problemen in den Teams beantwortet werden. Danach werden die Ergebnisse verglichen mit der Dokumentation, die das Team nutzt/produziert. Mögliche Diskrepanzen können dann Grundlage für weitere Rückfragen an die Entwickler sein. Durch das Interview und die Rückfragen soll die zweite Frage beantwortet werden können. Die letzten beiden Fragen werden im Diskussionsabschnitt der Arbeit behandelt.