Skip to main content
Article
Code comment quality analysis and improvement recommendation: An automated approach
International Journal of Software Engineering and Knowledge Engineering
  • Xiaobing SUN
  • Qiang GENG
  • David LO, Singapore Management University
  • Yucong DUAN
  • Xiangyue LIU
  • LI Bin
Publication Type
Journal Article
Publication Date
8-2016
Abstract

Program comprehension is one of the first and mostfrequently performed activities during software maintenance and evolution. In aprogram, there are not only source code, but also comments. Comments in aprogram is one of the main sources of information for program comprehension. Ifa program has good comments, it will be easier for developers to understand it.Unfortunately, for many software systems, due to developers’ poor coding styleor hectic work schedule, it is often the case that a number of methods andclasses are not written with good comments. This can make it difficult fordevelopers to understand the methods and classes, when they are performingfuture software maintenance tasks. To deal with this problem, in this paper wepropose an approach which assesses the quality of a code comment and generatessuggestions to improve comment quality. A user study is conducted to assess theeffectiveness of our approach and the results show that our comment qualityassessments are similar to the assessments made by our user study participants,the suggestions provided by our approach are useful to improve comment quality,and our approach can improve the accuracy of the previous comment qualityanalysis approaches.

Keywords
  • Program comprehension,
  • code comment quality analysis,
  • user study
Identifier
10.1142/S0218194016500339
Publisher
World Scientific Publishing
Additional URL
http://doi.org/10.1142/S0218194016500339
Citation Information
Xiaobing SUN, Qiang GENG, David LO, Yucong DUAN, et al.. "Code comment quality analysis and improvement recommendation: An automated approach" International Journal of Software Engineering and Knowledge Engineering Vol. 26 Iss. 6 (2016) p. 981 - 1000 ISSN: 0218-1940
Available at: http://works.bepress.com/david_lo/218/