Assessing the State of Software Documentation Practices
A system documentation process maturity model and assessment procedure were developed and used to assess 91 projects at 41 different companies over a seven year period. During this time the original version evolved into a total of four versions based on feedback from industry and the experience gained from the assessments. This paper reports the overall results obtained from the assessments which strongly suggest that the practice of documentation is not getting a passing grade in the software industry. The results show a clear maturity gap between documentation practices concerned with defining policy and practices concerned with adherence to those policies. The results further illustrate the need to recognize the importance of improving the documentation process, and to transform the good intentions into explicit policies and actions.
Keywordssystem documentation processes maturity model key practices degree of satisfaction assessment results
Unable to display preview. Download preview PDF.
- 2.Cook, C., Visconti, M.: Documentation is important. CrossTalk 7(11), 26–30 (1994)Google Scholar
- 3.Cook, C., Visconti, M.: New and improved documentation process model. In: Proceedings of the 14th Pacific Northwest Software Quality Conference, Portland, Oregon, October 1996, pp. 364–380. PNSQC, Portland (1996)Google Scholar
- 4.Humphrey, W.: Managing the software process. Addison-Wesley, Reading (1989)Google Scholar
- 6.Paulk, M., Curtis, B., Chrissis, M., Weber, C.: The Capability Maturity Model guidelines for improving the software process. Addison-Wesley, Reading (1995)Google Scholar
- 8.Pence, J., Hon III., S.: Building software quality into telecommunications network systems. Quality Progress, 95–97 (October 1993)Google Scholar
- 9.Rombach, H., Basili, V.: Quantitative assessment of maintenance: an industrial case study. In: Proceedings of the IEEE Conference on Software Maintenance, Austin, Texas, September 1987, pp. 134–144. IEEE, Washington (1987)Google Scholar
- 10.Visconti, M., Cook, C.: A software system documentation process maturity approach to software quality. In: Proceedings of the 11th Pacific Northwest Software Quality Conference, Portland, Oregon, October 1993, pp. 257–271. PNSQC, Portland (1993)Google Scholar
- 12.Cook, C., Visconti, M.: What to do after the assessment report? In: Proceedings of the 17th Pacific Northwest Software Quality Conference, Portland, Oregon, October 1999, pp. 214–228. PNSQC, Portland (1999)Google Scholar