How software engineers deal with decisions in Scrum – An analysis

Wie Softwareentwickler mit Entscheidungen in Scrum umgehen - Eine Analyse

  • The Agile Manifesto titled “Working software over comprehensive documentation”. Although the stated principle makes an important point, it should not follow that documentation becomes obsolete. On the contrary, agile software development (ASD) is based on frequent decisions focused on customer benefits. Those decisions guide further development, subsequent maintenance, and software evolution and are made during every stage of the software development cycle. Thus, documenting the most important ones is an important foundation fostering product comprehension, software quality, and customer benefit. Besides, preserving decision knowledge supports refactoring and, thus, diminishing software erosion. However, all these beneficial properties are opposed by a dismissive attitude among software developers. Documentation is very unpopular among software developers, especially in the ASD community. A common interpretation of the agile manifesto at this point is that good and functional code can fully replace documentation. Among otherThe Agile Manifesto titled “Working software over comprehensive documentation”. Although the stated principle makes an important point, it should not follow that documentation becomes obsolete. On the contrary, agile software development (ASD) is based on frequent decisions focused on customer benefits. Those decisions guide further development, subsequent maintenance, and software evolution and are made during every stage of the software development cycle. Thus, documenting the most important ones is an important foundation fostering product comprehension, software quality, and customer benefit. Besides, preserving decision knowledge supports refactoring and, thus, diminishing software erosion. However, all these beneficial properties are opposed by a dismissive attitude among software developers. Documentation is very unpopular among software developers, especially in the ASD community. A common interpretation of the agile manifesto at this point is that good and functional code can fully replace documentation. Among other reasons, this attitude is the reason for the sparse application of structured and systematic documentation of decisions and their rationale. To shed more light on imponderables, developer’s desires regarding decision documentation, and assess the outlined perception of a lack of decision documentation, this paper reports a survey on decision documentation in Scrum among industry practitioners. The author assesses to what extent the above claims hold by asking industry practitioners about their perceptions and applied practices regarding decision documentation in Scrum. Therefore, the author conducted a large-scale survey in the German and English speaking Scrum community. A few more than 100 software developers were asked what they document, how they document and how they use/share produced documentation. The findings of this report reveal that there is a wide range of opinions in the agile community. The responses show that a developer’s experience significantly impacts the documentation frequency and the interest in the available documentation. Similarly, the role in which software developers have operated in Scrum plays a significant role in the frequency of documentation and the timing when developers document.show moreshow less
  • Das Agile Manifest besagt sinngemäß "Funktionierende Software geht vor umfassende Dokumentation". Obwohl der genannte Grundsatz einen wichtigen Punkt darstellt, sollte daraus nicht folgen, dass Dokumentation obsolet wird. Im Gegenteil: Agile Softwareentwicklung (ASE) basiert auf häufigen Entscheidungen, die sich am Kundennutzen orientieren. Diese Entscheidungen leiten die weitere Entwicklung, die anschließende Wartung und die Software-Evolution und werden in jeder Phase des Software-Entwicklungszyklus getroffen. Daher ist die Dokumentation der wichtigsten Entscheidungen eine wichtige Grundlage, die das Produktverständnis, die Softwarequalität und den Kundennutzen fördert. Außerdem verbessert die Bewahrung von Entscheidungswissen das Refactoring und damit die Verringerung von Software-Erosion. All diesen positiven Eigenschaften steht jedoch eine ablehnende Haltung unter Softwareentwicklern gegenüber. Dokumentation ist bei Softwareentwicklern sehr unbeliebt, insbesondere in der ASE-Community. Eine gängige Interpretation des agilenDas Agile Manifest besagt sinngemäß "Funktionierende Software geht vor umfassende Dokumentation". Obwohl der genannte Grundsatz einen wichtigen Punkt darstellt, sollte daraus nicht folgen, dass Dokumentation obsolet wird. Im Gegenteil: Agile Softwareentwicklung (ASE) basiert auf häufigen Entscheidungen, die sich am Kundennutzen orientieren. Diese Entscheidungen leiten die weitere Entwicklung, die anschließende Wartung und die Software-Evolution und werden in jeder Phase des Software-Entwicklungszyklus getroffen. Daher ist die Dokumentation der wichtigsten Entscheidungen eine wichtige Grundlage, die das Produktverständnis, die Softwarequalität und den Kundennutzen fördert. Außerdem verbessert die Bewahrung von Entscheidungswissen das Refactoring und damit die Verringerung von Software-Erosion. All diesen positiven Eigenschaften steht jedoch eine ablehnende Haltung unter Softwareentwicklern gegenüber. Dokumentation ist bei Softwareentwicklern sehr unbeliebt, insbesondere in der ASE-Community. Eine gängige Interpretation des agilen Manifests ist an dieser Stelle, dass guter und funktionaler Code die Dokumentation vollständig ersetzen kann. Diese Einstellung ist unter anderem der Grund für die spärliche Anwendung von strukturierter und systematischer Dokumentation von Entscheidungen und deren Begründung. Um mehr Licht in die Unwägbarkeiten und Wünsche der Entwickler bezüglich der Entscheidungsdokumentation zu bringen und die skizzierte Wahrnehmung eines Mangels an Entscheidungsdokumentation zu bewerten, berichtet dieser Beitrag über eine Umfrage zum Thema Entscheidungsdokumentation in Scrum unter Entwicklern aus der Industrie. Der Autor erforscht, inwieweit die obigen Behauptungen zutreffen, indem er Praktiker aus der Industrie zu ihren Wahrnehmungen und angewandten Praktiken bezüglich der Entscheidungsdokumentation in Scrum befragt. Dazu führte der Autor in der deutsch- und englischsprachigen Scrum-Community eine umfangreiche Umfrage durch. Etwas mehr als 100 Softwareentwickler wurden befragt, was sie dokumentieren, wie sie dokumentieren und wie sie die erstellte Dokumentation nutzen/teilen. Die Ergebnisse zeigen, dass es eine große Bandbreite an Meinungen in der agilen Community gibt. Die Antworten lassen erkennen, dass die Erfahrung eines Entwicklers einen signifikanten Einfluss auf die Dokumentationshäufigkeit und das Interesse an der vorhandenen Dokumentation auswirkt. Ebenso ist die Rolle, in der Software Softwareentwickler in Scrum gearbeitet haben, entscheidend für die Häufigkeit der Dokumentation und den Zeitpunkt, wann Entwickler dokumentieren.show moreshow less

Download full text files

Export metadata

Additional Services

Search Google Scholar Stastistics
Metadaten
Author: Mathias Schubanz
URN:urn:nbn:de:kobv:co1-opus4-50662
DOI:https://doi.org/10.26127/BTUOpen-5066
Contributor(s): Mathias Schubanz
Document Type:Report
Language:English
Year of Completion:2021
Release Date:2021/06/08
Tag:Agiles Software Engineering; Begründungsmanagement; Entscheidungsdokumentation; Scrum; Umfrage
Agile software development; Decision documentation; Rationale management; Scrum; Survey
GND Keyword:Agile Softwareentwicklung; Scrum <Vorgehensmodell>; Programmdokumentation; Umfrage
Institutes:Fakultät 1 MINT - Mathematik, Informatik, Physik, Elektro- und Informationstechnik / FG Praktische Informatik / Softwaresystemtechnik
Licence (German):Creative Commons - CC BY - Namensnennung 4.0 International
Einverstanden ✔
Diese Webseite verwendet technisch erforderliche Session-Cookies. Durch die weitere Nutzung der Webseite stimmen Sie diesem zu. Unsere Datenschutzerklärung finden Sie hier.