An overview of mechanisms for improving software architecture understandability

Thema dieser Arbeit ist die Untersuchung von Verbesserungsmöglichkeiten für Software-Architekturdokumentation. Obwohl Software-Architekturverständlichkeit notwendig ist, um Software warten, entwickeln und wiederverwenden zu können, gibt es nur wenige evaluierte Richtlinien, um Software-Architektur nachvollziehbar und in sich schlüssig darzustellen. Problematisch wird dies, wenn Software-Diagramme nicht nur schwierig zu verstehen sind, sondern sogar missverständlich werden, wodurch das kostenintensive Erarbeiten der Architekturdiagramme verschwendet wäre. Um den Aufwand zu reduzieren und die Benutzbarkeit von Software-Architekturdiagrammen zu verbessern, wird diese Arbeit Überblick über Richtlinien, Prinzipien und Visualisierungsmöglichkeiten verschaffen, welche in der Literatur gefunden wurden. Es werden verschiedene Wege vorgestellt, um konzeptionelle Diagramme in drei Dimensionen zu verbessern: Notationen, Ästhetik und Struktur. Zusätzlich werden verschiedene Einussfaktoren auf Diagrammverständlichkeit diskutiert.

This thesis investigates multiple ways to improve software architecture understandability. Software architecture understandability is fundamental to re-usability, maintenance and the various engineering possibilities of software; nevertheless, only a limited number of evaluated guidelines exist to date regarding the visualization of software architecture that improve understandability. In the worst case, diagrams can be incomprehensible and ambiguous, resulting in a waste of cost-intensive designs of software architecture. To lessen effort and enhance usability of software architecture diagrams, this thesis gives an overview of guidelines, principles and visualization options found in literature. This thesis presents ways to improve conceptual diagrams using guidelines regarding three dimensions: notations, aesthetics and structure. In addition, different inuence factors on diagram understandability are discussed.