Fraunhofer-Gesellschaft

Publica

Hier finden Sie wissenschaftliche Publikationen aus den Fraunhofer-Instituten.

A view-based approach for improving software documentation practices

 
: Bayer, J.; Muthig, D.

:
Fulltext urn:nbn:de:0011-n-340556 (199 KByte PDF)
MD5 Fingerprint: d8c81760f3fff4dab1fabf672f87e09e
Created on: 06.12.2005


Kaiserslautern, 2003, VII, 23 pp. : Ill., Lit.
IESE-Report, 083.03/E
Reportnr.: 083.03/E
English
Report, Electronic Publication
Fraunhofer IESE ()
software documentation; separation of concerns; aspect-oriented approach

Abstract
Documentation is an integral part of a software system. It contains the information that is necessary to effectively and successfully develop, use, and maintain a system. In practice, however, the creation of appropriate documentation is largely neglected. This paper investigates the reasons for this neglect and proposes an approach to improve the current situation.
As the quality of documentation depends on its usage, the approach presented here realizes the software engineering principle separation of concerns to provide all documentation users with the documentation they require for performing their tasks.
The approach has been empirically validated in a series of experiment and case studies of which one experiment is described here in more detail.

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