KIT | KIT-Bibliothek | Impressum | Datenschutz

A Taxonomy for Design Decisions in Software Architecture Documentation

Keim, Jan ORCID iD icon; Hey, Tobias ORCID iD icon; Sauer, Bjarne; Koziolek, Anne ORCID iD icon

Abstract (englisch):

A software system is the result of all design decisions that were made during development and maintenance. Documentation, such as software architecture documentation, captures a variety of different design decisions. Classifying the kinds of design decisions facilitates various downstream tasks by enabling more targeted analyses. In this paper, we propose a taxonomy for design decisions in software architecture documentation to primarily support consistency checking. Existing taxonomies about design decisions have different purposes and do not fit well because they are too coarse. We take an iterative approach, starting with an initial taxonomy based on literature and considerations regarding consistency checking. Then, we mine open-source repositories to extract 17 software architecture documentations that we use to refine the taxonomy. We evaluate the resulting taxonomy with regard to purpose, structure, and application. Additionally, we explore the automatic identification and classification of design decisions in software architecture documentation according to the taxonomy. We apply different machine learning techniques, such as Logistic Regression, Decision Trees, Random Forests, and BERT to the 17 software architecture documentations. ... mehr


Postprint §
DOI: 10.5445/IR/1000160794/post
Veröffentlicht am 17.07.2024
Originalveröffentlichung
DOI: 10.1007/978-3-031-36889-9_29
Dimensions
Zitationen: 1
Cover der Publikation
Zugehörige Institution(en) am KIT Institut für Informationssicherheit und Verlässlichkeit (KASTEL)
KIT-Bibliothek (BIB)
Publikationstyp Proceedingsbeitrag
Publikationsjahr 2023
Sprache Englisch
Identifikator ISBN: 978-3-031-36889-9
ISSN: 0302-9743
KITopen-ID: 1000160794
HGF-Programm 46.23.01 (POF IV, LK 01) Methods for Engineering Secure Systems
Erschienen in Software Architecture. ECSA 2022 Tracks and Workshops – Prague, Czech Republic, September 19–23, 2022, Revised Selected Papers. Ed.: T. Batista
Veranstaltung 16th European Conference on Software Architecture (ECSA 2022), Prag, Tschechien, 19.09.2022 – 23.09.2022
Verlag Springer International Publishing
Seiten 439–454
Serie Lecture Notes in Computer Science
Vorab online veröffentlicht am 16.07.2023
Nachgewiesen in Scopus
Dimensions
Relationen in KITopen
KIT – Die Forschungsuniversität in der Helmholtz-Gemeinschaft
KITopen Landing Page