A value-based approach for documenting design decisions rationale: a replicated experiment

  • Authors:
  • Davide Falessi;Rafael Capilla;Giovanni Cantone

  • Affiliations:
  • University of Roma Tor Vergata, Rome, Italy;University Rey Juan Carlos, Madrid, Spain;University of Roma Tor Vergata, Rome, Italy

  • Venue:
  • Proceedings of the 3rd international workshop on Sharing and reusing architectural knowledge
  • Year:
  • 2008

Quantified Score

Hi-index 0.00

Visualization

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 value-based 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.