The documentation of design decisions in engineering projects: A study in infrastructure development

In most design projects, the documentation of design decisions is considered important. Among others, documentation of design decisions contributes to the traceability of decisions that shape a project’s development process, helps deal with changes in the project and prevents the recurrence of old discussions. Yet, little attention is given to documenting design decisions in civil engineering literature. In this study, a theoretical framework for the key elements of this documentation process was developed. Four road infrastructure projects were studied and compared to this framework by means of pattern matching. This method compares theoretical and empirical patterns and determines whether they match or do not match. The findings demonstrate that accessibility of documentation for all involved project parties and division of documentation tasks are in accordance with literature. However, the documentation of design decisions and their rationale is not done as completely as is recommended in theory. Literature states that the documentation of interrelations and context of decisions should be described thoroughly, but that is barely done in practice. In addition, the findings show that neither immediate documentation, nor periodical monitoring of documentation is applied. Based on these findings, this research proposes a strategy for improving the documentation of design decisions.

[1]  Dieter K. Hammer,et al.  Tool Support for Architectural Decisions , 2007, 2007 Working IEEE/IFIP Conference on Software Architecture (WICSA'07).

[2]  A. Huberman,et al.  Qualitative Data Analysis: A Methods Sourcebook , 1994 .

[3]  J. Varajão The many facets of information systems (+projects) success , 2022, International Journal of Information Systems and Project Management.

[4]  Chimay J. Anumba,et al.  Ontology‐based information and knowledge management in construction , 2008 .

[5]  Muhammad Ali Babar,et al.  A Survey of the Use and Documentation of Architecture Design Rationale , 2005, 5th Working IEEE/IFIP Conference on Software Architecture (WICSA'05).

[6]  Stephen C. Upton,et al.  Capturing Experimental Design Insights in Support of the Model-based System Engineering Approach , 2015 .

[7]  Muhammad Ali Babar,et al.  A Tool for Managing Software Architecture Knowledge , 2007, Second Workshop on Sharing and Reusing Architectural Knowledge - Architecture, Rationale, and Design Intent (SHARK/ADI'07: ICSE Workshops 2007).

[8]  Jose M. Framinan,et al.  XPDRL project: Improving the project documentation quality in the Spanish architectural, engineering and construction sector , 2010 .

[9]  Erik W. Aslaksen,et al.  Applying Systems Engineering to Infrastructure Projects , 2009 .

[10]  Farrokh Mistree,et al.  Ontology-Based Representation of Design Decision Hierarchies , 2016, J. Comput. Inf. Sci. Eng..

[11]  Jos Nijhuis,et al.  Design Decisions: The Bridge between Rationale and Architecture , 2006 .

[12]  Manoj Bhat,et al.  Towards a framework for managing architectural design decisions , 2017, ECSA.

[13]  Felix Schmid,et al.  Overcoming barriers to transferring systems engineering practices into the rail sector , 2012, Syst. Eng..

[14]  Frank Leymann,et al.  Managing architectural decision models with dependency relations, integrity constraints, and production rules , 2009, J. Syst. Softw..

[15]  Mohamad Fauzan Noordin,et al.  The current state of information management and knowledge management in the Malaysian construction industry , 2012 .

[16]  Michael Henshaw,et al.  The Risk of Information Management Without Knowledge Management: A Case Study , 2011, J. Inf. Knowl. Manag..

[17]  Philippe Kruchten,et al.  A Tool to Visualize Architectural Design Decisions , 2008, QoSA.

[18]  Gonzalo Navarro,et al.  Pattern Matching , 2008, Encyclopedia of Algorithms.

[19]  Martin Küster Architecture-Centric Modeling of Design Decisions for Validation and Traceability , 2013, ECSA.

[20]  R. S. (Robin) de Graaf,et al.  Applying systems engineering in the civil engineering industry: an analysis of systems engineering projects of a Dutch water board , 2017 .

[21]  Rafael Capilla,et al.  Modeling and Documenting the Evolution of Architectural Design Decisions , 2007, Second Workshop on Sharing and Reusing Architectural Knowledge - Architecture, Rationale, and Design Intent (SHARK/ADI'07: ICSE Workshops 2007).

[22]  Rainer Weinreich,et al.  Integrating Requirements and Design Decisions in Architecture Representation , 2010, ECSA.

[23]  Guangming Cao,et al.  The Need for a Systemic Approach to Change Management—A Case Study , 2004 .

[24]  Brigitte Moench,et al.  Engineering Design A Systematic Approach , 2016 .

[25]  Olaf Zimmermann,et al.  Sustainable Architectural Design Decisions , 2013, IEEE Software.

[26]  Jeff Tyree,et al.  Architecture decisions: demystifying architecture , 2005, IEEE Software.

[27]  Jan Bosch,et al.  Documenting after the fact: Recovering architectural design decisions , 2008, J. Syst. Softw..

[28]  Hans Voordijk,et al.  Implementing Systems Engineering in Civil Engineering Consulting Firm: An Evaluation , 2016, Syst. Eng..

[29]  Ronald Maier,et al.  Knowledge Management Systems , 2010 .

[30]  E. L. Riccio STRATEGIC INFORMATION MANAGEMENT: CHALLENGES AND STRATEGIES IN MANAGING INFORMATION SYSTEMS , 2006 .

[31]  Diederick Lutters,et al.  Networked Design Decisions in Balanced Life Cycles , 2014 .

[32]  Helen Lingard,et al.  Understanding the dynamics of construction decision making and the impact on work health and safety , 2017 .

[33]  Philippe Kruchten,et al.  An Ontology of Architectural Design Decisions in Software-Intensive Systems , 2004 .

[34]  Neil B. Harrison,et al.  Decision-Centric Architecture Reviews , 2013, IEEE Software.

[35]  Muhammad Ali Babar,et al.  A Framework for Supporting Architecture Knowledge and Rationale Management , 2006 .

[36]  John Haymaker,et al.  Framework for Measuring the Rationale Clarity of AEC Design Decisions , 2011 .

[37]  Pedro Daniel,et al.  A3 Architecture overviews. A tool for effective communication in product evolution , 2010 .

[38]  Geert P.M.R. Dewulf,et al.  Challenges of using systems engineering for design decisions in large infrastructure tenders , 2015 .

[39]  Zan Liu,et al.  Comprehensive Information Management Model of Construction Projects Based on System Engineering Methodology , 2017 .

[40]  Iris Groher,et al.  An expert survey on kinds, influence factors and documentation of design decisions in practice , 2015, Future Gener. Comput. Syst..

[41]  Eric Lutters,et al.  Evolving Product Information in Aligning Product Development Decisions across Disciplines , 2015 .

[42]  Susan P. Williams,et al.  Enterprise collaboration systems: addressing adoption challenges and the shaping of sociotechnical systems , 2022, International Journal of Information Systems and Project Management.

[43]  Sameer Bathallath,et al.  Managing project interdependencies in IT/IS project portfolios: a review of managerial issues , 2022, International Journal of Information Systems and Project Management.