DevDocOps: Enabling continuous documentation in alignment with DevOps. (28th November 2019)

• Record Type: Journal Article
• Authors: Rong, Guoping; Jin, Zefeng; Zhang, He; Zhang, Youwen; Ye, Wenhua; Shao, Dong
• Other Names: Bishop Judith guestEditor.; Cooper Kendra M.L. guestEditor.; Sharp Helen guestEditor.; Whalen Michael guestEditor.
• Is Part Of: Software, practice & experience. Volume 50:Number 3(2020)
• Page Start: 210
• Page End: 226
• Publication Date: 2019-11-28
• Subjects: automated documentation -- continuous delivery -- continuous documentation -- DevDocOps -- DevOps; Computer software -- Periodicals; Computer programming -- Periodicals; Computer programs -- Periodicals; 005.3
• DOI: 10.1002/spe.2770
• Languages: English
• ISSNs: 0038-0644

Abstract

Summary: The proliferation of DevOps enables significant acceleration and automation of the delivery and deployment of massive software products. Unfortunately, the development of supporting documents that is vital for large‐scale software systems in many cases does not keep pace with the rhythm of feature delivery using DevOps in practice, which becomes the bottleneck for many software organizations to deliver full value to the customers as claimed by the DevOps. This paper proposes, implements, and evaluates an integrated approach, DevDocOps, for continuous automated documentation, in particular for DevOps. With DevDocOps, supporting documents are created along with the development process simultaneously by various roles within a DevOps project, which largely guarantees the accuracy and integrity of documents as well as significantly increases their delivery speed. Within an established delivery chain, a set of templates are created to collect and transform the required information from its origin to the target documents for delivery. A real system, iDoc, is implemented to map, collect, and synthesize the information from document templates and automate the documentation process. DevDocOps has been successfully adopted in a top‐tier global telecommunication enterprise to support more than 5000 users with different roles related to documentation. The lag time between the releases of the product version and its supporting document has been shortened from 1 to 2 months on average to less than 2 days. DevDocOps extends the scope of DevOps and enhances the value delivery by supporting continuous documentation and bridges the gap between feature delivery and document delivery with automation.