AuthorsD. Falessi, R. Capilla and G. Cantone
EditorsP. Avgeriou, P. Lago and P. Kruchten
TitleValue-Based Design Decision Rationale Documentation: a Replicated Experiment
AfilliationSoftware Engineering, Software Engineering
Publication TypeProceedings, refereed
Year of Publication2008
Conference NameProceedings of the 3rd international workshop on Sharing and reusing architectural knowledge
ISBN Number978-1-60558-038-8

ABSTRACT The explicit documentation of the rationale of design decisions is a practice generally encouraged but rarely implemented in industry because of a variety of inhibitors. Known methods for Design Decisions Rationale Documentation (DDRD) are aimed to maximize the benefits for practitioners who should utilize the DDRD by imposing the burden on the developers of documenting all the potentially useful information. In our view, the adoption of a tailored DDRD, consisting only of the required set of information, would mitigate the effects of DDRD inhibitors. This paper focuses on confirming empirically the feasibility of a valuebased approach for documenting the rationale behind design decisions, and the importance of different DDRD information categories. In this context, this work describes a replicated experiment carried out at the University Rey Juan Carlos of Madrid (Spain) aimed to validate previous results from an analogous study conducted at the University of Roma Tor Vergata (Italy). Results confirm that the level of utility related to the same category of DDRD information significantly changes depending on its purpose.

Citation KeySimula.simula.478