A documentation framework for architecture decisions

  • Authors:
  • U. van Heesch;P. Avgeriou;R. Hilliard

  • Affiliations:
  • University of Groningen, Groningen, The Netherlands and Fontys University of Applied Sciences, Venlo, The Netherlands;University of Groningen, Groningen, The Netherlands;Consulting Software Systems Architect, Massachusetts, USA

  • Venue:
  • Journal of Systems and Software
  • Year:
  • 2012

Quantified Score

Hi-index 0.00

Visualization

Abstract

In this paper, we introduce a documentation framework for architecture decisions. This framework consists of four viewpoint definitions using the conventions of ISO/IEC/IEEE 42010, the new international standard for the description of system and software architectures. The four viewpoints, a Decision Detail viewpoint, a Decision Relationship viewpoint, a Decision Chronology viewpoint, and a Decision Stakeholder Involvement viewpoint satisfy several stakeholder concerns related to architecture decision management. With the exception of the Decision Stakeholder Involvement viewpoint, the framework was evaluated in an industrial case study. The results are promising, as they show that decision views can be created with reasonable effort while satisfying many of the stakeholder concerns in decision documentation.