CVSM Bibliography, Entry [ JaBA2008JSS ]


Jansen, Anton; Bosch, Jan; Avgeriou, Paris: Documenting After The Fact: Recovering Architectural Design Decisions; Journal of Systems and Software 81:4 (April 2008), p.536-557; 2008
Download: Volltext
Library Entries: ACM Digital Library
Deskriptoren: CVSM

Abstract: Software architecture documentation helps people in understanding the software architecture of a system. In practice, software architectures are often documented after the fact, i.e. they are maintained or created after most of the design decisions have been made and implemented. To keep the architecture documentation up-to-date an architect needs to recover and describe these decisions. This paper presents ADDRA, an approach an architect can use for recovering architectural design decisions after the fact. ADDRA uses architectural deltas to provide the architect with clues about these design decisions. This allows the architect to systematically recover and document relevant architectural design decisions. The recovered architectural design decisions improve the documentation of the architecture, which increases traceability, communication, and general understanding of a system.