arrow
Return

A mapping study on documentation in Continuous Software Development

delete2022-02-01
delete12
delete
OA
AI
T
Theo Theunissen *
U
Uwe van Heesch
P
Paris Avgeriou
DOI:10.1016/j.infsof.2021.106733delete
deleteOriginal
deleteShare
deleteSave
View PDF
Abstract

Abstract

En 中文
Context: With an increase in Agile, Lean, and DevOps software methodologies over the last years (collectively referred to as Continuous Software Development (CSD)), we have observed that documentation is often poor. Objective: This work aims at collecting studies on documentation challenges, documentation practices, and tools that can support documentation in CSD. Method: A systematic mapping study was conducted to identify and analyze research on documentation in CSD, covering publications between 2001 and 2019. Results: A total of 63 studies were selected. We found 40 studies related to documentation practices and challenges, and 23 studies related to tools used in CSD. The challenges include: informal documentation is hard to understand, documentation is considered as waste, productivity is measured by working software only, documentation is out-of-sync with the software and there is a short-term focus. The practices include: non-written and informal communication, the usage of development artifacts for documentation, and the use of architecture frameworks. We also made an inventory of numerous tools that can be used for documentation purposes in CSD. Overall, we recommend the usage of executable documentation, modern tools and technologies to retrieve information and transform it into documentation, and the practice of minimal documentation upfront combined with detailed design for knowledge transfer afterwards. Conclusion: It is of paramount importance to increase the quantity and quality of documentation in CSD. While this remains challenging, practitioners will benefit from applying the identified practices and tools in order to mitigate the stated challenges.
Keywords:
Systematic mapping studies
Systematic reviews
Continuous Software Development
Lean
Agile
DevOps
Documentation
AI Summary

AI Summary

Key information extracted from the uploaded paper, including a brief overview, abstract, background, key highlights, visual analysis, and future outlook.

Journal

Information and Software Technology cover
Information and Software Technology
IF:
4.3
Papers:
3.8K
Citations:
7.7K

Organization

U
University of Groningen
Scholars:
4.4W
Papers: 4.3W
Citations: 5.9W
Cited Papers

Cited Papers

Requirements engineering: A systematic mapping study in agile software development
err2018-05-01
err85
PREAI
errCurcio, Karina; Navarro, Tiago; Malucelli, Andreia; Reinehr, Sheila
errShare
errSave
Comparison of Frequency of Vascular Complications With Ultrasound-Guided Versus Fluroscopic Roadmap-Guided Femoral Arterial Access in Patients Who Underwent Transcatheter Aortic Valve Implantation
err2020-10-01
err0
PREAI
errSrinivasa P. Potluri; Mohanad Hamandi; Sukhdeep S. Basra; Kathryn V. Shinn; Deborah Tabachnick; Anupama Vasudevan; Giovanni Filardo; J. Michael DiMaio; William T. Brinkman; Katherine Harrington; John J. Squiers; Molly I. Szerlip; David L. Brown; Elizabeth Holper; Michael J. Mack
errShare
errSave
Towards a reduction in architectural knowledge vaporization during agile global software development
err2019-08-01
err27
errOAAI
errBorrego, Gilberto; Moran, Alberto L.; Palacio, Ramon R.; Vizcaino, Aurora; Garcia, Felix O.
errShare
errSave
Sustainable Architectural Design Decisions
err2013-11-01
err40
PREAI
errZdun, Uwe; Capilla, Rafael; Huy Tran; Zimmermann, Olaf
errShare
errSave
The Financial System of the EU 25
err2005-01-01
err0
PREAI
errFranklin Allen; Laura Bartiloro; Oskar Kowalewski
errShare
errSave
errShare
errSave
Scaling Agile
err2017-11-01
err88
PREAI
errEbert, Christof; Paasivaara, Maria
errShare
errSave
Movement and home range of owned free-roaming male dogs in Puerto Natales, Chile
err2018-08-01
err0
PREAI
errGuillermo E. Pérez; Annamaria Conte; Elena J. Garde; Stefano Messori; Raphael Vanderstichel; James Serpell
errShare
errSave
Forward-Looking MD&A Disclosures and the Information Environment
err2015-05-01
err0
PREAI
errVolkan Muslu; Suresh Radhakrishnan; K. R. Subramanyam; Dongkuk Lim
errShare
errSave
researcher View more