|
Evaluation of similarity of Javadoc comments
D. V. Koznova, E. I. Ledenevab, D. V. Luciva, P. I. Braslavskiic a Saint Petersburg State University
b Company "Yandex"
c National Research University Higher School of Economics
Abstract:
Code comments are an essential part of software documentation. Many software projects suffer the problem of low-quality comments that are often produced by copy-paste. In case of similar methods, classes, etc. copy-pasted comments with minor modifications are justified. However, in many cases this approach leads to degraded documentation quality and, subsequently, to problematic maintenance and development of the project. In this study, we address the problem of near-duplicate code comments detection, which can potentially improve software documentation. We have conducted a thorough evaluation of traditional string similarity metrics and modern machine learning methods. In our experiment, we use a collection of Javadoc comments from four industrial open-source Java projects. We have found out that LCS (Longest Common Subsequence) is the best similarity algorithm taking into account both quality (Precision 94%, Recall 74%) and performance.
Keywords:
software documentation, Javadoc comments, similarity measure
Citation:
D. V. Koznov, E. I. Ledeneva, D. V. Luciv, P. I. Braslavskii, “Evaluation of similarity of Javadoc comments”, Proceedings of ISP RAS, 35:4 (2023), 177–186
Linking options:
https://www.mathnet.ru/eng/tisp808 https://www.mathnet.ru/eng/tisp/v35/i4/p177
|
Statistics & downloads: |
Abstract page: | 23 | Full-text PDF : | 14 |
|