Guided Exploration and Visualization of Trace Links in Visual Studio Code

Moderne Softwaresysteme basieren auf zahlreichen miteinander verknüpften Artefakten: Anforderungen, Dokumentation, Modelle und Code. Traceability Links zwischen diesen Artefakten unterstützen das Verständnis, die Wartung und das Onboarding. Obwohl automatisierte Trace Link Recovery (TLR) Ansätze wie ARDoCo und LiSSA solche Links erzeugen können, nutzen Entwickler sie selten effektiv, da sie nicht in ihre tägliche Entwicklungsumgebung und Arbeitsabläufe integriert sind.
Diese Arbeit stellt trace-viz vor, eine Visual-Studio-Code-Erweiterung, die automatisch erzeugte oder importierte Trace Links direkt in die IDE integriert. ... mehrDie Erweiterung unterstützt verschiedene Trace-Visualisierungsmodi, wie etwa „Satz-zu-Datei“. Sie ermöglicht eine interaktive Erkundung der Trace Links durch Inline-Markierungen, kontextbezogene Tooltips und schnelle Navigation. Trace-viz wurde mit einer modularen und erweiterbaren Architektur entwickelt.
Eine Think-Aloud-Evaluation anhand von Softwareverständnisaufgaben zeigte, dass trace-viz die Effizienz und Genauigkeit von Entwicklern beim Arbeiten mit Trace Links verbessert. Teilnehmende berichteten von geringerem Navigationsaufwand, einem besseren Verständnis der Artefaktbeziehungen und höherer Sicherheit bei der Identifikation relevanter Dateien. Im Vergleich zur Nutzung von Trace Links im reinen CSV-Format führte die Erweiterung zu konsistenteren Aufgabenergebnissen und einer reduzierten kognitiven Belastung.
Die Ergebnisse zeigen, dass die direkte Einbettung von Trace-Link-Visualisierung in die IDE eine bedeutende Unterstützung für Softwareaufgaben, Verständnis und Wartung bietet. Trace-viz schließt erfolgreich die Lücke zwischen automatisierten TLR-Ansätzen und realen Entwicklerworkflows. Zukünftige Arbeiten sollten die Erweiterung der Visualisierungsmethoden und umfassendere Evaluierungen über verschiedene Projekttypen umfassen.

Modern software systems rely on numerous interconnected artifacts: requirements, documentation, models, and code. Traceability links between these artifacts support comprehension, maintenance, and onboarding of new personnel. While automated Trace Link Recovery (TLR) approaches such as ARDoCo and LiSSA can generate these links, developers rarely use them effectively because they are not integrated into their daily development environment and workflows.
This thesis introduces trace-viz, a Visual Studio Code extension that integrates automatically generated or imported trace links directly into the IDE. ... mehrThe extension supports multiple trace visualization modes like sentence-to-file. It enables interactive exploration of trace links through inline markers, context tooltips and quick navigation. Trace-viz was developed to have a modular and expandable architecture.
A think-aloud evaluation using software comprehension tasks showed that trace-viz improves developers efficiency and accuracy when working with trace links. Participants reported lower navigation effort, better understanding of artifact relationships, increased confidence identifying relevant files and were able to save time with their task. Compared to using trace links in raw CSV format, the extension led to more consistent task completion and reduced cognitive load.
The results demonstrate that embedding trace-link visualization directly into the IDE provides meaningful support for software tasks, comprehension and maintenance. Trace-viz successfully bridges the gap between automated TLR approaches and real-world developer workflows. Future work should include expanding visualization methods and conducting broader evaluations across diverse project types.