Advertisement

Springer Nature is making SARS-CoV-2 and COVID-19 research free. View research | View latest news | Sign up for updates

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

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

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.

This is a preview of subscription content, log in to check access.

Notes

  1. 1.

    https://de.atlassian.com/software/jira.

  2. 2.

    https://de.atlassian.com/software/confluence.

  3. 3.

    Möglicherweise bietet die Arbeit von Voigt (2017b) einen Ansatz hierfür.

Literatur

  1. Ambler SW (2018) Agile/lean documentation: strategies for agile software development. http://www.agilemodeling.com/essays/agileDocumentation.htm. Zugegriffen: 26. März 2019

  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 2019

  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 2019

  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

  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

  6. Gröber M (2013) Investigation of the usage of artifacts in agile methods. Master’s thesis, Technische Universität München

  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)

  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

  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

  10. Kanwal F, Bashir K, Ali AH (2014) Documentation practices for offshore agile software development. Life Sci J 11:70–73

  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 2019

  12. Liebold R, Trinczek R (2009) Experteninterview. In: Kühl S, Strodtholz P, Taffertshofer A (Hrsg) Handbuch Methoden der Organisationsforschung. VS, Wiesbaden, S 32–56

  13. Mayring P (2015) Qualitative Inhaltsanalyse: Grundlagen und Techniken, 12. Aufl. Beltz, Weinheim

  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)

  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

  16. Rüping A (2003) Agile documentation: a pattern guide to producing lightweight documents for software projects. Wiley, Chichester

  17. Rüping A (2013) Dokumentation in agilen Projekten: Lösungsmuster für ein bedarfsgerechtes Vorgehen. dpunkt.verlag, Heidelberg

  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 2019

  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

  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

  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

  22. Tripathi V, Goyal AK (2014) A document driven approach for agile software development. Int J Adv Res Comput Sci Softw Eng 4:1085–1090

  23. Uikey N, Suman U, Ramani AK (2011) A documented approach in agile software development. Int J Softw Eng 2:13–22

  24. Voigt S (2017a) A method for documenting agile software projects. In: Proceedings of the 18th European Conference on Knowledge Management (ECKM), S 1035–1044

  25. Voigt S (2017b) Entwicklung eines integrierten Konzeptes für die Dokumentation in agilen Softwareprojekten. Fraunhofer Verlag, Stuttgart

  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

Download references

Author information

Correspondence to Laura Mathews.

Rights and permissions

Reprints and Permissions

About this article

Verify currency and authenticity via CrossMark

Cite this article

Mathews, L., Holzweißig, K. Agile Dokumentation: Anspruch und Wirklichkeit – eine fallstudienbezogene Analyse mehrerer Softwareentwicklungsprojekte. HMD 57, 117–132 (2020). https://doi.org/10.1365/s40702-019-00558-x

Download citation

Schlüsselwörter

  • Agile Dokumentation
  • Softwaredokumentation
  • Dokumentation
  • Agile Softwareentwicklung
  • Scrum

Keywords

  • Agile documentation
  • Software documentation
  • Documentation
  • Agile software development
  • Scrum