Enhancing Software Comments Readability Using Flesch Reading Ease Score
Open Access
- 7 September 2020
- journal article
- research article
- Published by MDPI AG in Information
- Vol. 11 (9) , 430
Abstract
Comments are used to explain the meaning of code and ease communications between programmers themselves, quality assurance auditors, and code reviewers. A tool has been developed to help programmers write readable comments and measure their readability level. It is used to enhance software readability by providing alternatives to both keywords and comment statements from a local database and an online dictionary. It is also a word-finding query engine for developers. Readability level is measured using three different formulas: the fog index, the Flesch reading ease score, and Flesch–Kincaid grade levels. A questionnaire has been distributed to 42 programmers and 35 students to compare the readability aspect between both new comments written by the tool and the original comments written by previous programmers and developers. Programmers stated that the comments from the proposed tool had fewer complex words and took less time to read and understand. Nevertheless, this did not significantly affect the understandability of the text, as programmers normally have quite a high level of English. However, the results from students show that the tool affects the understandability of text and the time taken to read it, while text complexity results show that the tool makes new comment text that is more readable by changing the three studied variables.Keywords
This publication has 13 references indexed in Scilit:
- Validating Automated Measures of Text ComplexityEducational Measurement: Issues and Practice, 2017
- Coherence of comments and method implementations: a dataset and an empirical investigationSoftware Quality Journal, 2016
- Impact of Programming Features on Code ReadabilityInternational Journal of Software Engineering and Its Applications, 2013
- Quality analysis of source code comments2013
- Readability of Texts: State of the ArtTheory and Practice in Language Studies, 2012
- A New Metric for Code ReadabilityIOSR Journal of Computer Engineering, 2012
- Learning a Metric for Code ReadabilityIEEE Transactions on Software Engineering, 2009
- How documentation evolves over time2007
- Software Effort, Quality, and Cycle Time: A Study of CMM Level 5 ProjectsIEEE Transactions on Software Engineering, 2007
- Readability and Understandability: Different Measures of the Textual Complexity of Accounting NarrativeAccounting, Auditing & Accountability Journal, 1992