2010 · 37 citations · 12 references
ComputingComputer ScienceQuality ManagementQuality AssuranceQuality EngineeringSoftware EngineeringDocumentation AnalysisQuality MetricsSoftware DocumentationSoftware MetricsSoftware Quality AssuranceSoftware TestingClone DetectionCode Clone DetectionDocumentation EvaluationDocumentation QualityDocumentation Quality ManagementSoftware Evolution AnalysisTest CoverageTest Coverage Analysis
Technical documentation is now fully taking the step from stale printed booklets (or electronic versions of these) to interactive and online versions. This provides opportunities to reconsider how we define and assess the quality of technical documentation. This paper suggests an approach based on the Goal-Question-Metric paradigm: predefined quality goals are continuously assessed and visualized by the use of metrics. To test this approach, we perform two experiments. We adopt well known software analysis techniques, e.g., clone detection and test coverage analysis, and assess the quality of two real world documentations, that of a mobile phone and of (parts of) a warship. The experiments show that quality issues can be identified and that the approach is promising.
12
The Goal Question Metric Approach
Victor R. Basili, Gianluigi Caldiera, H. Dieter Rombach · 1994 · 1.6K citations
James A. McCall · Medical Entomology and Zoology · 1977 · 823 citations