QUALITY-CONTROL IN SOFTWARE DOCUMENTATION BASED ON MEASUREMENT OF TEXT COMPREHENSION AND TEXT COMPREHENSIBILITY
QUALITY-CONTROL IN SOFTWARE DOCUMENTATION BASED ON MEASUREMENT OF TEXT COMPREHENSION AND TEXT COMPREHENSIBILITY
复制标题
DOI：
10.1016/0306-4573(93)90079-s
复制
发表时间：
1993-09-01
影响因子：
8.6
通讯作者：
LEHNER, F
中科院分区：
文献类型：
--
作者：
LEHNER, F
软件文档的重要性和数据处理中糟糕的文档的影响往往被低估。很少有研究发表，评估软件文档的质量。文本属性的评价，如可理解性、可读性等，已经看到了更多的研究和相对合理的结果。因此，本文专门处理文本文档，其中的方法用于评估软件文档。本文首先介绍了文本可理解性的测量方法。然后介绍了作者开发的一个支持测量过程的工具RMS（Readability Measuring System）。本文第三部分介绍了实证结果，并讨论了在应用RMS工具方面取得的经验。
The importance of software documentation and the effects of poor documentation in data processing are often underrated. Little research has been published that evaluates the quality of software documentation. The evaluation of textual attributes such as comprehensibility, readability, etc., has seen more studies and relatively sound results. Thus this paper exclusively handles textual documentation, whereby the methods are employed for the evaluation of software documentation. We first introduce the methods used in the measurement of text comprehensibility. Then RMS (Readability Measuring System), a tool developed by the author to support the measuring process, is presented. The third part of the paper presents empirical results and discusses the experience gained in the application of the RMS tool.