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. Methods proposed in the past for Design Decisions Rationale Documentation (DDRD) aimed to maximize benefits for the DDRD consumer by imposing on the producer of DDRD the burden to document all the potentially useful information. We propose here a compromise which consists in tailoring DDRD, based on its intended use or purpose. In our view, the adoption of a tailored DDRD, consisting only of the required set of information, would mitigate the effects of DDRD inhibitors. The aim of this paper is twofold: i) to discuss the application of Value-Based Software Engineering principles to DDRD, ii) to describe a controlled experiment to empirically analyze the feasibility of the proposed method. Results show that the level of utility related to the same category of DDRD information significantly changes depending on its purpose; such result is novel and it demonstrates the feasibility of the proposed value-based DDRD.

Falessi, D., Cantone, G., Kruchten, P. (2008). Value-based design decision rationale documentation: Principles and empirical feasibility study. In 7th IEEE/IFIP Working Conference on Software Architecture, WICSA 2008 (pp.189-198). LOS ALAMITOS : IEEE COMPUTER SOC [10.1109/WICSA.2008.8].

Value-based design decision rationale documentation: Principles and empirical feasibility study

Falessi D.;CANTONE, GIOVANNI;
2008-01-01

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. Methods proposed in the past for Design Decisions Rationale Documentation (DDRD) aimed to maximize benefits for the DDRD consumer by imposing on the producer of DDRD the burden to document all the potentially useful information. We propose here a compromise which consists in tailoring DDRD, based on its intended use or purpose. In our view, the adoption of a tailored DDRD, consisting only of the required set of information, would mitigate the effects of DDRD inhibitors. The aim of this paper is twofold: i) to discuss the application of Value-Based Software Engineering principles to DDRD, ii) to describe a controlled experiment to empirically analyze the feasibility of the proposed method. Results show that the level of utility related to the same category of DDRD information significantly changes depending on its purpose; such result is novel and it demonstrates the feasibility of the proposed value-based DDRD.
7th IEEE/IFIP Working Conference on Software Architecture, WICSA 2008
Vancouver, CANADA
FEB 18-22, 2008
7
IEEE, IFIP
Rilevanza internazionale
contributo
17-set-2008
2008
Settore ING-INF/05 - SISTEMI DI ELABORAZIONE DELLE INFORMAZIONI
English
Data structures; Decision making; Planning; Resource allocation; Software engineering; Technology; Controlled experiments; Design decisions; Feasibility studies; Software engineering principles; Value-based; Software architecture
Intervento a convegno
Falessi, D., Cantone, G., Kruchten, P. (2008). Value-based design decision rationale documentation: Principles and empirical feasibility study. In 7th IEEE/IFIP Working Conference on Software Architecture, WICSA 2008 (pp.189-198). LOS ALAMITOS : IEEE COMPUTER SOC [10.1109/WICSA.2008.8].
Falessi, D; Cantone, G; Kruchten, P
File in questo prodotto:
File Dimensione Formato  
2008_WICSA_FCK_Value-Based Design Decision Rationale Documentation Principles and empirical feasibility study.pdf

accesso aperto

Descrizione: Articolo principale
Dimensione 603.41 kB
Formato Adobe PDF
603.41 kB Adobe PDF Visualizza/Apri

I documenti in IRIS sono protetti da copyright e tutti i diritti sono riservati, salvo diversa indicazione.

Utilizza questo identificativo per citare o creare un link a questo documento: https://hdl.handle.net/2108/57813
Citazioni
  • ???jsp.display-item.citation.pmc??? ND
  • Scopus 20
  • ???jsp.display-item.citation.isi??? ND
social impact