Understanding source code comments at large-scale

Source code comments are important for any software, but the basic patterns of writing comments across domains and programming languages remain unclear. In this paper, we take a first step toward understanding differences in commenting practices by analyzing the comment density of 150 projects in 5 different programming languages. We have found that there are noticeable differences in comment density, which may be related to the programming language used in the project and the purpose of the project.

• Publication year

  2019

• Venue

  ESEC/SIGSOFT FSE

• Publication date

  2019-08-12

• Fields of study

  Computer Science

• Identifiers
  DOI 10.1145/3338906.3342494
• External record

  Open on Semantic Scholar

• Source metadata

  Semantic Scholar

• No claims are published for this paper.

• No concepts are published for this paper.

• World of Code: An Infrastructure for Mining the Universe of Open Source VCS Data

  2019cited by this paper
• 9.6 Million Links in Source Code Comments: Purpose, Evolution, and Decay

  2019cited by this paper
• Deep Code Comment Generation

  2018cited by this paper
• A Neural Framework for Retrieval and Summarization of Source Code

  2018cited by this paper
• Summarizing Source Code with Transferred API Knowledge

  2018cited by this paper
• Classifying Code Comments in Java Open-Source Software Systems

  2017cited by this paper
• Summarizing Source Code using a Neural Attention Model

  2016cited by this paper
• AutoComment: Mining question and answer sites for automatic comment generation

  2013cited by this paper
• GHTorrent: Github's data from a firehose

  2012cited by this paper
• How Good is Your Comment? A Study of Comments in Java Programs

  2011cited by this paper
• Listening to programmers — Taxonomies and characteristics of comments in operating system code

  2009cited by this paper
• Analyzing the co-evolution of comments and source code

  2009cited by this paper
• The comment density of open source software code

  2009cited by this paper
• Oracle

  2008cited by this paper
• /*icomment: bugs or bad comments?*/

  2007cited by this paper
• Code quality analysis in open source software development

  2002cited by this paper
• Metrics for assessing a software system's maintainability

  1992cited by this paper
• Program Readability: Procedures Versus Comments

  1988cited by this paper
• The effect of modularization and comments on program comprehension

  1981cited by this paper
• Sphinx

  1937cited by this paper

• Understanding comment practices in Scratch: A study of comments in a block-based visual programming language

  2025cites this paper
• Literate Tracing

  2025cites this paper
• LLMCup: Ranking-Enhanced Comment Updating with LLMs

  2025cites this paper
• The process and value of reprogramming a legacy global hydrological model

  2025cites this paper
• Automatic Code Summarization Using Abbreviation Expansion and Subword Segmentation

  2025cites this paper
• Bash comment generation via data augmentation and semantic-aware CodeBERT

  2024cites this paper
• Do Code Summarization Models Process Too Much Information? Function Signature May Be All That Is Needed

  2024cites this paper
• Generative Software Engineering

  2024cites this paper
• MESIA: Understanding and Leveraging Supplementary Nature of Method-level Comments for Automatic Comment Generation

  2024cites this paper
• Beyond code: Is there a difference between comments in visual and textual languages?

  2024cites this paper
• Software sustainability of global impact models

  2024cites this paper
• Purpose Enhanced Reasoning through Iterative Prompting: Uncover Latent Robustness of ChatGPT on Code Comprehension

  2024cites this paper
• Formalizing Natural Language Intent into Program Specifications via Large Language Models

  2023cites this paper
• PENTACET data - 23 Million Contextual Code Comments and 250,000 SATD comments

  2023cites this paper
• ALSI-Transformer: Transformer-Based Code Comment Generation With Aligned Lexical and Syntactic Information

  2023cites this paper
• Can Large Language Models Transform Natural Language Intent into Formal Method Postconditions?

  2023cites this paper
• ClassSum: a deep learning model for class-level code summarization

  2022cites this paper
• Suboptimal Comments in Java Projects: From Independent Comment Changes to Commenting Practices

  2022cites this paper
• Source Code Summarization with Structural Relative Position Guided Transformer

  2022cites this paper
• GT-SimNet: Improving code automatic summarization via multi-modal similarity networks

  2022cites this paper
• ComFormer: Code Comment Generation via Transformer and Fusion Method-based Hybrid Code Representation

  2021cites this paper
• Characterising the Knowledge about Primitive Variables in Java Code Comments

  2021cites this paper
• Suggesting Comment Completions for Python using Neural Language Models

  2020cites this paper