Linking Software Architecture Documentation and Models

In der Softwareentwicklung ist die Konsistenz zwischen Artefakten ein wichtiges Thema. Diese Arbeit schlägt eine Struktur zur Erkennung von korrespondierenden und fehlenden Elementen zwischen einer Dokumentation und einem formalen Modell vor.
Zunächst identifiziert und extrahiert der Ansatz die im Text beschriebenen Modellinstanzen und -beziehungen. Dann verbindet der Ansatz diese Textelemente mit ihren
entsprechenden Gegenstücken im Modell. Diese Verknüpfungen sind mit TraceLinks vergleichbar. Der Ansatz erlaubt jedoch die Abstufung dieser Links. Darüber hinaus generiert der Ansatz Empfehlungen für Elemente, die nicht im Modell enthalten sind. ... mehr
Der Ansatz identifiziert Modellnamen und -typen mit einem F1-Score von über 54%. 60% der empfohlenen Instanzen stimmen mit den in der Benutzerstudie gefundenen Instanzen überein. Bei der Identifizierung von Beziehungen und dem Erstellen von Verknüpfungen erzielte der Ansatz vielversprechende Ergebnisse. Die Ergebnisse können durch zukünftige Arbeiten verbessert werden. Dies ist realisierbar da der Entwurf eine einfache Erweiterung des Ansatzes erlaubt.

In software engineering, consistency between artifacts is an important topic. This thesis proposes a structure for detecting mutual and missing elements between a documentation and a formal model.
First, the approach identifies and extracts model instances and relations described in the text. Then, the approach connects these textual elements to their corresponding counterparts in the model. These links are comparable to trace links. However, the approach allows the graduation of these links. Moreover, the approach generates recommendations for elements that could not be found in the model.
... mehr
The approach identifies model names and types with an F1-Score above 54%. 60% of the recommended instances match the instances found in the user study. For the identification of relations and the creation of links the approach achieved promising results. The results can be improved through future work. This can be realized because the design allows an easy implementation of extensions.