Advertisement

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

  • Laura MathewsEmail author
  • Kai Holzweißig
Spektrum
  • 49 Downloads

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.

Schlüsselwörter

Agile Dokumentation Softwaredokumentation Dokumentation Agile Softwareentwicklung Scrum 

Agile documentation: theory and reality – a case study based analysis of various software engineering projects

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.

Keywords

Agile documentation Software documentation Documentation Agile software development Scrum 

Literatur

  1. Ambler SW (2018) Agile/lean documentation: strategies for agile software development. http://www.agilemodeling.com/essays/agileDocumentation.htm. Zugegriffen: 26. März 2019Google Scholar
  2. Beck K, Beedle M, van Bennekum A, Cockburn A, Cunnigham W, Fowler M, Grenning J, Highsmith J, Hunt A, Jeffries R, Kern J, Marick B, Martin RC, Mellor S, Schwaber K, Sutherland J, Thomas D (2001a) Manifesto for agile software development. http://agilemanifesto.org/. Zugegriffen: 20. März 2019Google Scholar
  3. Beck K, Beedle M, van Bennekum A, Cockburn A, Cunnigham W, Fowler M, Grenning J, Highsmith J, Hunt A, Jeffries R, Kern J, Marick B, Martin RC, Mellor S, Schwaber K, Sutherland J, Thomas D (2001b) Prinzipien hinter dem Agilen Manifest. http://agilemanifesto.org/iso/de/principles.html. Zugegriffen: 20. März 2019Google Scholar
  4. Bouillon E, Güldali B, Herrmann A, Keuler T, Moldt D, Riebisch M (2013) Leichtgewichtige Traceability im agilen Entwicklungsprozess am Beispiel von Scrum. Softwaretechnik-Trends 33:29–30.  https://doi.org/10.1007/BF03323544 CrossRefGoogle Scholar
  5. Dingsøyr T, Nerur S, Balijepally V, Moe NB (2012) A decade of agile methodologies: towards explaining agile software development. J Syst Softw 85:1213–1221.  https://doi.org/10.1016/j.jss.2012.02.033 CrossRefGoogle Scholar
  6. Gröber M (2013) Investigation of the usage of artifacts in agile methods. Master’s thesis, Technische Universität MünchenGoogle Scholar
  7. Hachemi A, Ahmed-Nacer M (2011) Documentation agile: pratiques actuelles et défis. In: Proceedings of the Third International Conference on Computer Science and its Applications (CIIA’11)Google Scholar
  8. Hadar I, Sherman S, Hadar E, Harrison JJ (2013) Less is more: Architecture documentation for agile development. In: 2013 6th International Workshop on Cooperative and Human Aspects of Software Engineering (CHASE), S 121–124.  https://doi.org/10.1109/CHASE.2013.6614746 CrossRefGoogle Scholar
  9. Hoda R, Noble J, Marshall S (2012) Documentation strategies on agile software development projects. Int J Agile Extreme Softw Dev 1:23–37.  https://doi.org/10.1504/IJAESD.2012.048308 CrossRefGoogle Scholar
  10. Kanwal F, Bashir K, Ali AH (2014) Documentation practices for offshore agile software development. Life Sci J 11:70–73Google Scholar
  11. Komus A, Kuberg M (2017) Status Quo Agile: Studie zu Verbreitung und Nutzen agiler Methoden: Eine empirische Untersuchung. https://www.gpm-ipma.de/fileadmin/user_upload/GPM/Know-How/Studie_Status_Quo_Agile_2017.pdf. Zugegriffen: 18. März 2019Google Scholar
  12. Liebold R, Trinczek R (2009) Experteninterview. In: Kühl S, Strodtholz P, Taffertshofer A (Hrsg) Handbuch Methoden der Organisationsforschung. VS, Wiesbaden, S 32–56CrossRefGoogle Scholar
  13. Mayring P (2015) Qualitative Inhaltsanalyse: Grundlagen und Techniken, 12. Aufl. Beltz, WeinheimGoogle Scholar
  14. Myklebust T, Stålhane T, Hanssen GK, Wien T, Haugset B (2014) Scrum, documentation and the IEC 61508-3:2010 software standard. In: Proceedings of Probabilistic Safety Assessment and Management (PSAM)Google Scholar
  15. Rubin E, Rubin H (2011) Supporting agile software development through active documentation. Requir Eng 16:117–132.  https://doi.org/10.1007/s00766-010-0113-9 CrossRefGoogle Scholar
  16. Rüping A (2003) Agile documentation: a pattern guide to producing lightweight documents for software projects. Wiley, ChichesterGoogle Scholar
  17. Rüping A (2013) Dokumentation in agilen Projekten: Lösungsmuster für ein bedarfsgerechtes Vorgehen. dpunkt.verlag, HeidelbergGoogle Scholar
  18. Schwaber K, Sutherland J (2016) Der Scrum Guide: Der gültige Leitfaden für Scrum: Die Spielregeln. http://www.scrumguides.org/docs/scrumguide/v2016/2016-Scrum-Guide-German.pdf. Zugegriffen: 20. März 2019Google Scholar
  19. Stettina CJ, Heijstek W (2011) Necessary and neglected? An empirical study of internal documentation in agile software development teams. In: Proceedings of the 29th ACM international conference on Design of communication (SIGDOC ’11). ACM, New York, S 159–166.  https://doi.org/10.1145/2038476.2038509 Google Scholar
  20. Stettina CJ, Kroon E (2013) Is there an agile handover? an empirical study of documentation and project handover practices across agile software teams. In: 2013 International Conference on Engineering, Technology and Innovation (ICE) & IEEE International Technology Management Conference, S 1–12.  https://doi.org/10.1109/ITMC.2013.7352703 Google Scholar
  21. Stettina CJ, Heijstek W, Fægri TE (2012) Documentation work in agile teams: the role of documentation formalism in achieving a sustainable practice. In: 2012 Agile Conference, S 31–40.  https://doi.org/10.1109/Agile.2012.7 CrossRefGoogle Scholar
  22. Tripathi V, Goyal AK (2014) A document driven approach for agile software development. Int J Adv Res Comput Sci Softw Eng 4:1085–1090Google Scholar
  23. Uikey N, Suman U, Ramani AK (2011) A documented approach in agile software development. Int J Softw Eng 2:13–22Google Scholar
  24. Voigt S (2017a) A method for documenting agile software projects. In: Proceedings of the 18th European Conference on Knowledge Management (ECKM), S 1035–1044Google Scholar
  25. Voigt S (2017b) Entwicklung eines integrierten Konzeptes für die Dokumentation in agilen Softwareprojekten. Fraunhofer Verlag, StuttgartGoogle Scholar
  26. Wagenaar G, Overbeek S, Lucassen G, Brinkkemper S, Schneider K (2018) Working software over comprehensive documentation – rationales of agile teams for artefacts usage. J Softw Eng Res Dev 6:7.  https://doi.org/10.1186/s40411-018-0051-7 CrossRefGoogle Scholar

Copyright information

© Springer Fachmedien Wiesbaden GmbH, ein Teil von Springer Nature 2019

Authors and Affiliations

  1. 1.Studienzentrum WirtschaftsinformatikDuale Hochschule Baden-Württemberg StuttgartStuttgartDeutschland

Personalised recommendations