Fraunhofer-Gesellschaft

Publica

Hier finden Sie wissenschaftliche Publikationen aus den Fraunhofer-Instituten.

Task-Specific Architecture Documentation for Developers

Why Separation of Concerns in Architecture Documentation is Counterproductive for Developers
 
: Rost, Dominik; Naab, Matthias

:
Volltext urn:nbn:de:0011-n-4383330 (576 KByte PDF)
MD5 Fingerprint: a3b0266e9b89e6026a7d67e506dbcc02
Erstellt am: 29.3.2017


Kaiserslautern, 2016, 8 S.
IESE-Report, 058.16./E
Reportnr.: 058.16/E
Englisch
Bericht, Elektronische Publikation
Fraunhofer IESE ()
architecture documentation; implementation; task; separation of concerns

Abstract
It is widely agreed that architecture documentation, independent of its form, is necessary to prescribe architectural concepts for development and to con-serve architectural information over time. However, very often architecture documentation is perceived as inadequate, too long, too abstract, too detailed, or simply outdated. While developers have tasks to develop certain features or parts of a system, they are confronted with architecture documents that globally de-scribe the architecture and use concepts like separation of concerns. Then, the developers have the hard task to find all information of the separated concerns and to synthesize the excerpt relevant for their concrete task. Ideally, they would get an architecture document, which is exactly tailored to their need of architectural information for their task at hand. Such documentation can however not be created by architects in reasonable time. In this paper, we propose an approach of modeling architecture and automatically synthesizing a tailored architecture documentation for each developer and each development task. Therefor architectural concepts are selected from the model based on the task and an interleaving of concepts is done. This makes for example all interfaces explicit, which a component has to implement in order to comply with security, availability, etc. concepts. The required modeling and automation is realized in the tool Enterprise Architect. We got already very positive feedback for this idea from practitioners and expect a significant improvement of implementation quality and architecture compliance.

: http://publica.fraunhofer.de/dokumente/N-438333.html