Informatics in Education logo


Login Register

  1. Home
  2. To appear
  3. The Pedagogical Role of Source Code Comm ...

Informatics in Education

INFORMATION Submit your article Become a reviewer Join INFEDU as an Associate Editor Help
  • Article info
  • Related articles
  • More
    Article info Related articles

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.

Related articles PDF XML
Related articles 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 2020
150

Article info
views

40

PDF
downloads

14

XML
downloads

Export citation

Copy and paste formatted citation
Placeholder

Download citation in file


Share


RSS

INFORMATICS IN EDUCATION

  • Online ISSN: 2335-8971
  • Print ISSN: 1648-5831
  • Copyright © The Author(s), CC BY 4.0
  •  

For contributors

  • Submit
  • OA Policy

Contact us

  • Institute of Data Science and Digital Technologies,
  • Vilnius University, Akademijos St. 4, 08412, Vilnius, Lithuania
  • E-mail: editorial@infedu.lt
Powered by PubliMill  •  Privacy policy