Code Comment Quality Analysis and Improvement Recommendation: An Automated Approach
Xiaobing Sun, GENG Qiang -, David Lo et al. · International Journal of Software Engineering and Knowledge Engineering · 2016
Program comprehension is one of the first and most frequently performed activities during software maintenance and evolution. In a program, there are not only source code, but also comments. Comments in a program is one of the main sources of information for program comprehension. If a program has good comments, it will be easier for developers to understand it. Unfortunately, for many software systems, due to developers’ poor coding style or hectic work schedule, it is often the case that a number of methods and classes are not written with good comments. This can make it difficult for developers to understand the methods and classes, when they are performing future software maintenance tasks. To deal with this problem, in this paper we propose an approach which assesses the quality of a code comment and generates suggestions to improve comment quality. A user study is conducted to assess the effectiveness of our approach and the results show that our comment quality assessments 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 quality analysis approaches.
Cited by 12 works. doi:10.1142/s0218194016500339
Authors
References
- Empirical Studies of Programming Knowledge
- Program comprehension during software maintenance and evolution
- Using Students as Subjects—A Comparative Study of Students and Professionals in Lead-Time Impact Assessment
- Code quality analysis in open source software development
- The effect of modularization and comments on program comprehension
- Quality analysis of source code comments
- The Elements of Java™ Style
- Triaging incoming change requests: Bug or commit history, or code authorship?
- Automatic Quality Assessment of Source Code Comments: The JavadocMiner
- Leveraged Quality Assessment using Information Retrieval Techniques