VTeX: Solutions for Science Publishing logo


  • List of journals
  • Browse subjects
  • About Publisher
  • Help
  • Sitemap
Login Register

  1. Home
  2. Journals
  3. INFEDU
  4. To appear
  5. The Pedagogical Role of Source Code Comm ...

Informatics in Education

Submit your article Information
  • Article info
  • More
    Article info

The Pedagogical Role of Source Code Comments in Programming Education: A Qualitative Systematic Review with Layered Evidence
Gonçalo SARMENTO   Manuel J. C. S. REIS ORCID icon link to view author Manuel J. C. S. REIS details  

Authors

 
Placeholder
https://doi.org/10.15388/infedu.2603.031
Pub. online: 1 June 2026      Type: Early View Article      Open accessOpen Access

Published
1 June 2026

Abstract

Source code comments are usually treated in software engineering as documentation artifacts that support readability, maintainability, and long-term comprehension. In programming education, however, comments may also function as pedagogical scaffolds by helping learners externalize reasoning, clarify intent, and reflect on code. This article presents a PRISMA-informed qualitative systematic review with layered evidence on the pedagogical role of source code comments in programming education. Searches in Scopus and ERIC produced 50 unique records; 36 were assessed in detail and resolved into 18 primary synthesis studies, 7 supporting/contextual studies, and 11 advanced-stage exclusions. Because the evidence base is heterogeneous, the review uses qualitative layered synthesis rather than meta-analysis. The findings suggest that comments are best understood pedagogically as explanation-centered learning supports, especially for code comprehension, self-explanation, debugging and reflective reasoning, and formative assessment of student thinking. Direct comment-focused evidence remains limited and concentrated mainly in highereducation and novice programming contexts; adjacent explanation-centered studies clarify plausible mechanisms but do not by themselves establish comment-specific effects. The review concludes that comments can become pedagogically meaningful when deliberately integrated as scaffolds for explanation, comprehension, and reflection.

PDF XML
PDF XML

Copyright
© 2026 G. Sarmento, M. J. C. S. Reis. Published by Vilnius University in cooperation with Tallinn University
Open access article under the CC BY license.

Keywords
source code comments programming education program comprehension self-explanation metacognition qualitative systematic review

Metrics
since February 2017
0

Article info
views

0

PDF
downloads

0

XML
downloads

Export citation

Copy and paste formatted citation
Placeholder

Download citation in file


Share


RSS

  • About Publisher
Powered by PubliMill  •  Privacy policy