This metric measures the percentage of lines in files that are comments. A low number of comments may indicate files that are difficult to understand due to poor documentation.

Consider if the file needs more documentation.

  • Jeff Atwood. Avoiding Undocumentation. 2005.
  • Steve McConnell. Code Complete. 2nd Edition. Microsoft Press. 2004.