DevDocOps: Towards Automated Documentation for DevOpsSEIPIndustry Program
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 some 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 DevOps. This paper proposes, implements, and evaluates a new approach, DevDocOps, for continuous automated documentation, in particular for DevOps. With DevDocOps, developers can create the documents simultaneously with their working versions of software, which largely guarantees the documents’ accuracy and integrity as well as significantly increases their delivery speed. A real system, iDoc, is implemented to map, collect, and synthesize the information from document templates and automate the documentation process. The iDoc system supports the generation of documents in minutes and the instant feedback loop as well. DevDocOps has been successfully adopted in over 30 software projects in a top tier global telecommunication enterprise. The lag time between the releases of the product version and its supporting document has been shortened from 1-2 months on average to less than 2 days. DevDocOps extends the scope of DevOps and enhances value delivery by supporting continuous documentation and bridging the gap between feature delivery and document delivery with automation.