Please use this identifier to cite or link to this item: http://hdl.handle.net/20.500.11889/8406
Title: Enhancing software comments readability using flesch reading ease score
Authors: Eleyan, Derar 
Othman, Abed 
Eleyan, Amna 
Keywords: Flesch–Kincaid;Flesch reading ease score;Fog index;Computer software - Development;Readability;Application software - Development;Software code;Software comment;Software quality
Issue Date: 2020
Publisher: Information (Switzerland)
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 di erent 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 a ect the understandability of the text, as programmers normally have quite a high level of English. However, the results from students show that the tool a ects 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.
URI: http://hdl.handle.net/20.500.11889/8406
DOI: 10.3390/INFO11090430
Appears in Collections:Fulltext Publications

Files in This Item:
File Description SizeFormat
Enhancing software comments readability using flesch reading ease score.pdf6.36 MBAdobe PDFView/Open
Show full item record

Page view(s)

17
checked on Jun 18, 2024

Download(s)

9
checked on Jun 18, 2024

Google ScholarTM

Check

Altmetric


Items in DSpace are protected by copyright, with all rights reserved, unless otherwise indicated.