<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Publishing DTD v1.0 20120330//EN" "JATS-journalpublishing1.dtd">
<article xmlns:xlink="http://www.w3.org/1999/xlink" article-type="Research Article" xmlns:mml="http://www.w3.org/1998/Math/MathML">
  <front>
    <journal-meta>
      <journal-id journal-id-type="publisher-id">INFEDU</journal-id>
      <journal-title-group>
        <journal-title>Informatics in Education</journal-title>
      </journal-title-group>
      <issn pub-type="epub">2335-8971</issn>
      <issn pub-type="ppub">1648-5831</issn>
      <publisher>
        <publisher-name>VU</publisher-name>
      </publisher>
    </journal-meta>
    <article-meta>
      <article-id pub-id-type="publisher-id">INFEDU.2603.031</article-id>
      <article-id pub-id-type="doi">10.15388/infedu.2603.031</article-id>
      <article-categories>
        <subj-group subj-group-type="heading">
          <subject>Early View Article</subject>
        </subj-group>
      </article-categories>
      <title-group>
        <article-title>The Pedagogical Role of Source Code Comments in Programming Education: A Qualitative Systematic Review with Layered Evidence</article-title>
      </title-group>
      <contrib-group>
        <contrib contrib-type="author">
          <name>
            <surname>SARMENTO</surname>
            <given-names>Gonçalo</given-names>
          </name>
          <email xlink:href="mailto:al82369@alunos.utad.pt">al82369@alunos.utad.pt</email>
          <xref ref-type="aff" rid="j_INFEDU_aff_001" />
        </contrib>
        <contrib contrib-type="author">
          <name>
            <surname>REIS</surname>
            <given-names>Manuel J. C. S.</given-names>
          </name>
          <contrib-id contrib-id-type="orcid">https://orcid.org/0000-0002-8872-5721</contrib-id>
          <email xlink:href="mailto:mcabral@utad.pt">mcabral@utad.pt</email>
          <xref ref-type="aff" rid="j_INFEDU_aff_002" />
          <xref ref-type="corresp" rid="cor1" />
        </contrib>
        <aff id="j_INFEDU_aff_001">Quinta de Prados, Vila Real, Universidade de Trás-os-Montes e Alto Douro, Portugal</aff>
        <aff id="j_INFEDU_aff_002">Quinta de Prados, Vila Real, Departamento de Engenharias &amp; IEETA, Escola de Ciências e Tecnologia, Universidade de Trás-os-Montes e Alto Douro, Portugal</aff>
      </contrib-group>
      <author-notes>
        <corresp id="cor1">
          <label>∗</label>Corresponding author. Email: mcabral@utad.pt</corresp>
      </author-notes>
      <volume>0</volume>
      <issue>0</issue>
      <fpage>1</fpage>
      <lpage>37</lpage>
      <pub-date pub-type="epub">
        <day>01</day>
        <month>06</month>
        <year>2026</year>
      </pub-date>
      <permissions>
        <copyright-year>2026</copyright-year>
        <copyright-holder>The Author(s)</copyright-holder>
        <copyright-statement>© 2026 G. Sarmento, M. J. C. S. Reis. Published by Vilnius University in cooperation with Tallinn University</copyright-statement>
        <license license-type="open-access">
          <license-p>Open access article under the CC BY license.</license-p>
        </license>
      </permissions>
      <abstract>
        <p>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.</p>
      </abstract>
      <kwd-group>
        <label>Keywords</label>
        <kwd>source code comments</kwd>
        <kwd>programming education</kwd>
        <kwd>program comprehension</kwd>
        <kwd>self-explanation</kwd>
        <kwd>metacognition</kwd>
        <kwd>qualitative systematic review</kwd>
      </kwd-group>
    </article-meta>
  </front>
</article>
