2010 Seventh International Conference on the Quality of Information and Communications Technology (2010)
Sept. 29, 2010 to Oct. 2, 2010
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.
Information quality, Quality assurance, Software metrics, Documentation
A. Wingkvist, R. Lincke, M. Ericsson and W. Löwe, "A Metrics-Based Approach to Technical Documentation Quality," 2010 Seventh International Conference on the Quality of Information and Communications Technology(QUATIC), Porto, Portugal, 2010, pp. 476-481.