An Overview of Industrial Software Documentation Practice

  • Authors:
  • Marcello Visconti;Curtis R. Cook

  • Affiliations:
  • -;-

  • Venue:
  • SCCC '02 Proceedings of the XII International Conference of the Chilean Computer Science Society
  • Year:
  • 2002

Quantified Score

Hi-index 0.00

Visualization

Abstract

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 asessments 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 intensions into explicit policies and actions.