Title :
Assessing the adequacy of documentation through document quality indicators
Author :
Arthur, James D. ; Stevens, K. Todd
Author_Institution :
Dept. of Comput. Sci., Virginia Polytch. Inst. & State Univ., Blacksburg, VA, USA
Abstract :
Case study results for a research effort funded by the US Naval Surface Warfare Center (NSWC) are presented. The investigation focuses on assessing the adequacy of project documentation based on an identified taxonomic structure relating documentation characteristics. Previous research in this area has been limited to the study of isolated characteristics of documentation and English prose, without considering the collective contributions of such characteristics. The research described takes those characteristics, adds others and establishes a well-defined approach to assessing the `goodness´ of software documentation. The identification of document quality indicators (DQIs) provides the basis for the assessment procedure. DQIs are hierarchically defined in terms of document qualities, factors that refine qualities, and quantifiers that provide for the measurement of factors
Keywords :
quality control; software reliability; system documentation; DQIs; English prose; NSWC; US Naval Surface Warfare Center; assessment procedure; collective contributions; document quality indicators; documentation characteristics; identified taxonomic structure; project documentation; software documentation; well-defined approach; Computer science; Costs; Documentation; Process control; Relational databases; Reverse engineering; Software development management; Software maintenance; Software measurement; Software quality;
Conference_Titel :
Software Maintenance, 1989., Proceedings., Conference on
Conference_Location :
Miami, FL
Print_ISBN :
0-8186-1965-1
DOI :
10.1109/ICSM.1989.65192