Impact of Comment Statement on Code Stability in Open Source Development

Aman Hirohisa, Hirokazu Okazaki · Frontiers in artificial intelligence and applications · 2008

Comment statements written in a source code are important information to understand and to maintain the source code. This paper performs an empirical study of impacts of comment statements on source code stability in an open source development. The study collected 4,521 source code and their version-upgrade data from a major open source software project, Eclipse. The empirical results show the following findings: (1) a source code with a high comment-density (about more than 40%) has a tendency to be stable through the upgrdes, but (2) a source code with frequently-written comments has the opposite tendency. This work thus concludes that describing many comments is recommend for developing a stable code, but frequently describing comments is discouraged.

Read the paper · More papers on PaperTik