title: DecXtract: Dokumentation und
Nutzung von Entscheidungswissen in
JIRA-Issue-Kommentaren
Creators: name: Clormann, Jochen
Publisher: name: Heidelberg University Library
Year: 2019

description: [Kontext und Motivation] Zur Entwicklung eines Softwaresystems benötigen EntwicklerIn-
nen Wissen über die Evolution der zugehörigen Softwareartefakte. EntwicklerInnen müssen bei-
spielsweise vorangegangene Quellcodeänderungen verstehen, um eine neue Anforderung bzw. ei-
ne ¨ Anderung an einer bestehenden Anforderung zu implementieren. Dabei spielt Entscheidungs-
wissen eine zentrale Rolle für die erfolgreiche Evolution eines Softwaresystems: EntwicklerInnen
benötigen Wissen zu bereits getroffenen Entscheidungen, um eigene Entscheidungen zu treffen.
Um neuen EntwicklerInnen in einem Softwareprojekt den Zugriff auf dieses Entscheidungswis-
sen zu ermöglichen, ist es wichtig, dass Projektbeteiligte Entscheidungen dokumentieren. Dafür
nutzen sie verschiedene Dokumentationsmöglichkeiten und halten Entscheidungswissen häufig
informell in Commitnachrichten, Chatnachrichten oder Kommentaren fest.
[Beitr¨ age] Diese Masterarbeit umfasst eine systematische Literaturrecherche, die Entwick-
lung des JIRA-Plug-Ins DecXtract sowie einen Datensatz als Goldstandard zur Evaluation.
Die systematische Literaturrecherche beantwortet die Frage, welches Wissen EntwicklerInnen
für das Verständnis von Quellcodeänderungen benötigen und welche Rolle Entscheidungswis-
sen dafür spielt. Neben einer Liste mit konkreten Fragen, die EntwicklerInnen zu einer Quell-
codeänderung stellen, zeigt die Literaturrecherche, dass EntwicklerInnen explizites Entschei-
dungswissen benötigen, dieses aber nicht dokumentiert oder auffindbar ist. Um Entscheidungs-
wissen in Kommentaren explizit zu machen und seine Auffindbarkeit zu verbessern, wird das
Entscheidungsdokumentationstool ConDec für JIRA um die Komponente DecXtract erweitert.
DecXtract ermöglicht EntwicklerInnen, Text in Kommentaren von JIRA-Issues automatisch als
Entscheidungswissen zu klassifizieren sowie eigene Kommentare manuell als explizites, klassi-
fiziertes Entscheidungswissen zu dokumentieren. EntwicklerInnen können Entscheidungswissen
in Kommentaren zu bestehenden Softwareartefakten wie Anforderungen, Entwicklungsaufga-
ben oder anderem Entscheidungswissen verlinken. So entsteht ein integriertes Wissensmodell
mit explizit dokumentiertem Entscheidungswissen. Dieses integrierte Modell wird als Graph
visualisiert und bietet NutzerInnen verschiedene Möglichkeiten zur Verwaltung.
Eine Befragung von EntwicklerInnen, die ebenfalls am ConDec-Projekt beteiligt sind, zeigt
die Eignung von DecXtract zur Dokumentation von Entscheidungswissen. Zur Evaluation wird
ein JIRA-Projekt mit 90 JIRA-Issues des Apache LUCENE Projektes erzeugt. Mit Hilfe von
DecXtract wird informelles Entscheidungswissen aus den JIRA-Issue-Kommentaren explizit an-
gelegt und miteinander verlinkt. Anhand der identifizierten Fragen von EntwicklerInnen an eine
Quellcodeänderung wird das von DecXtract bereitgestellte Wissen genutzt um das Verständnis
von Quellcodeänderungen zu evaluieren.
[Schlussfolgerung] DecXtract verbessert die Entscheidungsdokumentation durch die Klassifi-
kation von Entscheidungselementen in JIRA-Issue-Kommentaren. Durch das präsentierte Ent-
scheidungswissen können EntwicklerInnen immer den aktuellen Stand einer Diskussion und des
dazugehörigen Entscheidungsproblems beobachten. Wenn eine Quellcodeänderung mit einem
JIRA-Issue verlinkt ist, können EntwicklerInnen das Entscheidungswissen zu einer Quellco-
deändeurng betrachtet. Dieses Wissen unterstützt EntwicklerInnen beim Verständnis der Quell-
codeänderung.