An industrial case study on an architectural assumption documentation framework
Artikel i vetenskaplig tidskrift, 2017

As an important type of architectural knowledge, documenting architectural assumptions (AAs) is critical to the success of projects. In this work, we proposed and validated an Architectural Assumption Documentation Framework (AADF), which is composed of four viewpoints (i.e., the Detail, Relationship, Tracing, and Evolution viewpoint), to document AAs in projects. One case study with two cases was conducted at two companies from different domains and countries. The main findings are: (1) AADF can be understood by architects in a short time (i.e., a half day workshop); (2) the AA Evolution view requires the least time to create, followed by the AA Detail view and the AA Relationship view; (3) AADF can help stakeholders to identify risks and understand AAs documented by other stakeholders; and (4) understanding and applying AADF is related to various factors, including factors regarding the framework per se (e.g., tutorial, examples, concepts, and terms), personal experience, resources (e.g., time), tool support, and project context (e.g., project size and number of AAs). Adjusting these factors in an appropriate way can facilitate the usage of AADF and further benefit the projects.

Architectural assumption

Software architecture

Case study

Documentation framework

Författare

Chen Yang

Wuhan University

Rijksuniversiteit Groningen

Peng Liang

Wuhan University

Paris Avgeriou

Rijksuniversiteit Groningen

Ulf Eliasson

Volvo Cars

Chalmers, Data- och informationsteknik

Rogardt Heldal

Chalmers, Data- och informationsteknik, Software Engineering

Patrizio Pelliccione

Göteborgs universitet

Tingting Bi

Wuhan University

Journal of Systems and Software

0164-1212 (ISSN)

Vol. 134 190-210

Ämneskategorier

Data- och informationsvetenskap

DOI

10.1016/j.jss.2017.09.007