Open Access

Mathias Schubanz

• Managing decisions in software development, especially in the agile context, is a challenging task. Often, decisions can be traced back through actions taken or the source code. However, the "Why?" behind these decisions is frequently unclear. The absence of explanations significantly complicates future development, maintenance, or further advancements. Also intriguing is the question of "Why not?" – why was an alternative solution discarded? These questions are central to software developers. In contrast, linear models like the waterfall approach tend to over-document. Product and process documentation, along with detailed manuals, are common. However, they fail to address the dilemma of asymmetry between supply and demand. The paradigm shift towards agile methods hasn't solved this problem, possibly exacerbating it. Though the agile manifesto emphasizes communication over documentation, many developers misunderstand it, considering code the sole documentation. This work addresses this issue within the Scrum framework, aiming toManaging decisions in software development, especially in the agile context, is a challenging task. Often, decisions can be traced back through actions taken or the source code. However, the "Why?" behind these decisions is frequently unclear. The absence of explanations significantly complicates future development, maintenance, or further advancements. Also intriguing is the question of "Why not?" – why was an alternative solution discarded? These questions are central to software developers. In contrast, linear models like the waterfall approach tend to over-document. Product and process documentation, along with detailed manuals, are common. However, they fail to address the dilemma of asymmetry between supply and demand. The paradigm shift towards agile methods hasn't solved this problem, possibly exacerbating it. Though the agile manifesto emphasizes communication over documentation, many developers misunderstand it, considering code the sole documentation. This work addresses this issue within the Scrum framework, aiming to integrate the documentation of important decisions more systematically. It includes a literature review to determine what and to what extent should be documented. Additionally, it explores how this documentation can be effectively integrated into the Scrum process. To achieve these goals, practical experiences were gathered through interviews and a comprehensive survey. Industry-experienced software developers and several hundred students participated in case studies. The resulting data complement existing research and help identify ways to structure documentation, processing, and reuse decision knowledge in Scrum. Based on these insights, an extension of the Scrum framework called Custom-MADE Scrum was derived. It features an adaptive and flexible approach to documenting decisions and their rationale. It also defines clear responsibilities and provides process modules for the structured integration of decision documentation. This extension can be integrated into both existing and new projects. In addition to the extension, a tool called Custom-MADE Editor was developed. It aims to leverage automation to streamline documentation within Custom-MADE Scrum, making the process as efficient as possible. Overall, the author presents a flexible approach to systematically integrate decision documentation into the Scrum framework. The results are based on various empirical works.…
• Das Managen von Entscheidungen in der Softwareentwicklung, insbesondere im agilen Kontext, stellt eine anspruchsvolle Aufgabe dar. Oft können Entscheidungen anhand von durchgeführten Aktionen oder dem Quellcode nachvollzogen werden. Häufig bleibt jedoch das "Warum?" unklar. Das Fehlen von Begründungen erschwert zukünftige Entwicklungsarbeiten, Wartungsarbeiten oder etwaige Weiterentwicklungen erheblich. Besonders interessant ist auch oft die Frage nach dem "Warum nicht?" – also warum wurde eine Lösungsalternative verworfen? Diese Fragen sind zentral für Softwareentwickler. Im Gegensatz dazu tendieren lineare Vorgehensmodelle wie das Wasserfall-Modell dazu, übermäßig viel zu dokumentieren. Produkt- und Prozessdokumentation sowie detaillierte Handbücher sind hier üblich. Sie lösen jedoch nicht das Dilemma der Asymmetrie zwischen Angebot und Nachfrage. Der Paradigmenwechsel hin zu agilen Methoden hat dieses Problem auch nicht gelöst, sondern möglicherweise sogar verschärft. Das agile Manifest betont zwar die Kommunikation überDas Managen von Entscheidungen in der Softwareentwicklung, insbesondere im agilen Kontext, stellt eine anspruchsvolle Aufgabe dar. Oft können Entscheidungen anhand von durchgeführten Aktionen oder dem Quellcode nachvollzogen werden. Häufig bleibt jedoch das "Warum?" unklar. Das Fehlen von Begründungen erschwert zukünftige Entwicklungsarbeiten, Wartungsarbeiten oder etwaige Weiterentwicklungen erheblich. Besonders interessant ist auch oft die Frage nach dem "Warum nicht?" – also warum wurde eine Lösungsalternative verworfen? Diese Fragen sind zentral für Softwareentwickler. Im Gegensatz dazu tendieren lineare Vorgehensmodelle wie das Wasserfall-Modell dazu, übermäßig viel zu dokumentieren. Produkt- und Prozessdokumentation sowie detaillierte Handbücher sind hier üblich. Sie lösen jedoch nicht das Dilemma der Asymmetrie zwischen Angebot und Nachfrage. Der Paradigmenwechsel hin zu agilen Methoden hat dieses Problem auch nicht gelöst, sondern möglicherweise sogar verschärft. Das agile Manifest betont zwar die Kommunikation über Dokumentation, doch viele Entwickler interpretieren dies falsch und betrachten Code als die einzige Dokumentation. Die vorliegende Arbeit setzt an diesem Problem im Rahmen des Scrum-Frameworks an. Ihr Ziel ist es, die Dokumentation von wichtigen Entscheidungen strukturierter in den Scrum-Prozess zu integrieren. Die Arbeit umfasst eine Literaturuntersuchung, um festzustellen, was und in welchem Umfang dokumentiert werden sollte. Darüber hinaus beschäftigt sie sich mit der Frage, wie diese Dokumentation effektiv in den Scrum-Prozess integriert werden kann. Um diese Ziele zu erreichen, wurden Erfahrungen aus der Praxis durch Interviews und eine umfassende Umfrage eingeholt. Industrieerfahrene Softwareentwickler sowie mehrere hundert Studierende wurden in Fallstudien einbezogen. Die resultierenden Daten ergänzen den bestehenden Stand der Forschung und helfen, Wege für eine strukturierte Dokumentation, Verarbeitung und Wiederverwendung von Entscheidungswissen in Scrum zu identifizieren. Basierend auf den neuen Erkenntnissen wurde eine Erweiterung des Scrum-Frameworks namens Custom-MADE Scrum abgeleitet. Sie zeichnet sich durch einen adaptiven und flexiblen Ansatz zur Dokumentation von Entscheidungen und ihrer Begründung aus. Weiterhin definiert sie klare Verantwortlichkeiten und bietet Prozessbausteine für die strukturierte Integration der Dokumentation relevanter Entscheidungen in. Diese Erweiterung kann sowohl in bestehende als auch neu aufzusetzende Projekte integriert werden. Zusätzlich zu der Erweiterung wurde ein Werkzeug namens Custom-MADE Editor entwickelt. Es zielt darauf alle Potenziale zur Automatisierung der Dokumentation innerhalb des Custom-MADE Scrum zu heben, um den Prozess so effizient wie möglich zu gestalten. Insgesamt präsentiert der Autor einen flexiblen Ansatz zur systematischen Integration von Entscheidungsdokumentation in das Scrum-Framework. Die Ergebnisse stützen sich auf verschiedene empirische Arbeiten.…