Agile Dokumentation: Anspruch und Wirklichkeit – eine fallstudienbezogene Analyse mehrerer Softwareentwicklungsprojekte

Zusammenfassung

Die agile Softwareentwicklung gewinnt in der heutigen Unternehmenspraxis zunehmend an Bedeutung und löst an vielen Stellen klassische Vorgehensmodelle ab. Dies wirft aus wissenschaftlicher Sicht die Frage auf, welche Konsequenzen für etablierte Praktiken, wie beispielsweise die Softwaredokumentation, damit verbunden sind. Während die Dokumentation in der klassischen Softwareentwicklung einen hervorgehobenen Stellenwert besitzt, wird ihr Wert im Rahmen agiler Praktiken hingegen relativiert. Da weder im Agilen Manifest noch in den agilen Methoden konkrete Vorgaben hinsichtlich der Dokumentation existieren, stellt die Gestaltung dieser eine große Herausforderung für agile Projekte dar. Im Rahmen des vorliegenden Artikels wird daher eine kritische Betrachtung des Themas vorgenommen. Hierzu wird der aktuelle Stand der Forschung erhoben sowie eine fallstudienbezogene Analyse mehrerer Softwareentwicklungsprojekte bei einem weltweit tätigen Unternehmen der Softwareentwicklungsbranche durchgeführt. Die Ergebnisse zeigen, dass weder in Theorie noch Praxis verbindliche oder einheitliche Standards bezüglich der empfohlenen Dokumentationsartefakte sowie eines Dokumentationsvorgehens existieren. Dennoch werden durch die betrachteten Fallbeispiele verschiedene Realisierungsmöglichkeiten einer Softwaredokumentation im agilen Umfeld aufgezeigt. Ferner werden mögliche Gründe für die Heterogenität agiler Dokumentationspraktiken diskutiert, um Anhaltspunkte für weiteren Forschungsbedarf zu geben.

Abstract

Agile software development is becoming more and more relevant in today’s business practices and supersedes classical approaches in many places. From a scientific point of view, this change entails many consequences for established practices, such as for software documentation. While documentation is ascribed high importance in classical software development, its role is often subordinate in agile practices. As neither in the Agile Manifesto nor in the different agile methods any concrete guidelines regarding documentation are given, the criteria of good documentation are unclear for agile projects. This situation provides the motivation for the present article, which conducts a critical analysis of agile documentation. The current state of research is discussed and a case study of multiple software development projects is conducted at a global player in the software development industry. The results show that neither in theory nor in practice binding or uniform standards regarding recommended documentation artefacts and documentation approaches exist. However, the different case samples studied offer deeper insights into different options of software documentation in the agile context. Furthermore, potential reasons for the heterogeneity of agile documentation practices are discussed in order to provide indications for further research.