Fraunhofer-Gesellschaft

Publica

Hier finden Sie wissenschaftliche Publikationen aus den Fraunhofer-Instituten.

Software architecture documentation for developers. A survey

 
: Naab, Matthias; Rost, Dominik; Lima, Crescencio; Flach Chavez, Christina von

:
Fulltext urn:nbn:de:0011-n-3377592 (695 KByte PDF)
MD5 Fingerprint: f387cb7cef346f845ad4e8bce6d51710
Created on: 13.5.2015


Kaiserslautern, 2014, 16 pp.
IESE-Report, 089.14/E
Reportnr.: 089.14/E
English
Report, Electronic Publication
Fraunhofer IESE ()
software architecture; documentation; survey; software development; implementation; industry transfer

Abstract
Software architecture has become an established discipline in industry. Nevertheless, the available documentation of architecture is often not perceived as adequate by developers. As a foundation for the improvement of methods and tools around architecture documentation, we conducted a survey with 147 industrial participants, investigating their current problems and wishes for the future. Participants from different countries in Europe, Asia, North and South America shared their experiences. This paper presents the results of the survey. The results confirmed the common belief that architecture documentation is most frequently outdated and inconsistent and backed it up with data. Further, developers perceive difficulties with a "one-size-fits-all" architecture documentation, which does not adequately provide information for their specific task and context. Developers seek for more interactive ways of working with architecture documentation that allow finding needed information more easily with extended navigation and search possibilities.

: http://publica.fraunhofer.de/documents/N-337759.html