[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"detail-sidebar-cat-0-en-105":3,"doc-seo-578217-105":59,"doc-detail-578217-en":131},{"code":4,"msg":5,"data":6},0,"success",[7,13,18,23,28,33,38,43,48,51,55],{"id":8,"doc_module":4,"doc_module_name":9,"category_name":10,"show_sort_weight":11,"slug":12},1,"Document","Story & Novel",90,"story-novel",{"id":14,"doc_module":4,"doc_module_name":9,"category_name":15,"show_sort_weight":16,"slug":17},2,"Literature",80,"literature",{"id":19,"doc_module":4,"doc_module_name":9,"category_name":20,"show_sort_weight":21,"slug":22},4,"Exam",70,"exam",{"id":24,"doc_module":4,"doc_module_name":9,"category_name":25,"show_sort_weight":26,"slug":27},5,"Comic",60,"comic",{"id":29,"doc_module":4,"doc_module_name":9,"category_name":30,"show_sort_weight":31,"slug":32},6,"Technology",50,"technology",{"id":34,"doc_module":4,"doc_module_name":9,"category_name":35,"show_sort_weight":36,"slug":37},7,"Healthcare",40,"healthcare",{"id":39,"doc_module":4,"doc_module_name":9,"category_name":40,"show_sort_weight":41,"slug":42},8,"Research & Report",30,"research-report",{"id":44,"doc_module":4,"doc_module_name":9,"category_name":45,"show_sort_weight":46,"slug":47},9,"Religion & Spirituality",20,"religion-spirituality",{"id":46,"doc_module":4,"doc_module_name":9,"category_name":49,"show_sort_weight":46,"slug":50},"World Cup","world-cup",{"id":52,"doc_module":4,"doc_module_name":9,"category_name":53,"show_sort_weight":52,"slug":54},10,"Lifestyle","lifestyle",{"id":56,"doc_module":4,"doc_module_name":9,"category_name":57,"show_sort_weight":24,"slug":58},19,"General","general",{"code":4,"msg":60,"data":61},"ok",{"site_id":62,"language":63,"slug":64,"title":65,"keywords":66,"description":67,"schema_data":68,"social_meta":124,"head_meta":126,"extra_data":128,"updated_unix":130},105,"en","the-pedagogical-role-of-source-code-comments-in-programming-education-a-qualitative-systematic-review-with-layered-evidence","The Pedagogical Role of Source Code Comments in Programming Education - A Qualitative Systematic Review with Layered Evidence","","Source code comments are commonly framed in software engineering as documentation that improves readability, maintainability, and long-term understanding. In programming education, comments may instead operate as pedagogical scaffolds that support explanation, intent clarification, and reflective reasoning. This article reports a PRISMA-informed qualitative systematic review with layered evidence on comments’ pedagogical role in programming education, synthesizing Scopus/ERIC findings into primary, supporting, and exclusion studies. Results indicate layered qualitative mechanisms for comprehension, self-explanation, debugging, reflection, and formative assessment of student thinking.",{"@graph":69,"@context":123},[70,84,106],{"@type":71,"itemListElement":72},"BreadcrumbList",[73,77,79,82],{"item":74,"name":75,"@type":76,"position":8},"https://docshare.wps.com","Home","ListItem",{"item":78,"name":9,"@type":76,"position":14},"https://docshare.wps.com/document/",{"item":80,"name":40,"@type":76,"position":81},"https://docshare.wps.com/document/research-report/",3,{"item":83,"name":65,"@type":76,"position":19},"https://docshare.wps.com/document/the-pedagogical-role-of-source-code-comments-in-programming-education-a-qualitative-systematic-review-with-layered-evidence/578217/",{"url":83,"name":65,"@type":85,"image":86,"author":91,"headline":65,"publisher":94,"fileFormat":97,"inLanguage":63,"description":67,"dateModified":98,"datePublished":99,"encodingFormat":97,"isAccessibleForFree":100,"interactionStatistic":101},"DigitalDocument",{"url":87,"@type":88,"width":89,"height":90},"https://docshare.wps.com/thumbnails/the-pedagogical-role-of-source-code-comments-in-programming-education-a-qualitative-systematic-review-with-layered-evidence/578217.png","ImageObject",300,407,{"name":92,"@type":93},"Ivy","Person",{"url":74,"name":95,"@type":96},"DocShare","Organization","application/pdf","2026-11-15","2026-10-15",true,{"@type":102,"interactionType":103,"userInteractionCount":105},"InteractionCounter",{"@type":104},"ViewAction",11,{"@type":107,"mainEntity":108},"FAQPage",[109,115,119],{"name":110,"@type":111,"acceptedAnswer":112},"How does the review define the pedagogical role of source code comments in programming education?","Question",{"text":113,"@type":114},"It frames comments as more than documentation artifacts, treating them as scaffolds that can support learners’ explanation, intent clarification, and reflective reasoning during code interaction.","Answer",{"name":116,"@type":111,"acceptedAnswer":117},"What method and evidence structure does the article use?",{"text":118,"@type":114},"The article uses a PRISMA-informed qualitative systematic review with layered synthesis, based on searches in Scopus and ERIC and subsequent organization into primary synthesis, supporting/contextual, and exclusion sets.",{"name":120,"@type":111,"acceptedAnswer":121},"What learning outcomes does the review associate with comment-based supports?",{"text":122,"@type":114},"Findings suggest comments can support explanation-centered learning, particularly for code comprehension, self-explanation, debugging, reflective reasoning, and formative assessment of students’ thinking.","https://schema.org",{"og:url":83,"og:type":125,"og:title":65,"og:site_name":95,"og:description":67},"article",{"robots":127,"canonical":83},"index,follow",{"doc_id":129,"site_id":62},578217,1792121993,{"code":4,"msg":5,"data":132},{"doc_id":129,"user_id":133,"nickname":92,"user_avatar":134,"doc_module":4,"category_id":39,"category_name":40,"doc_title":65,"doc_description":67,"doc_content":135,"file_id":136,"file_url":137,"file_type":138,"file_size":139,"view_count":105,"is_deleted":4,"is_public":8,"is_downloadable":8,"audit_status":8,"page_count":140,"language":141,"language_code":63,"site_id":62,"html_lang":63,"table_of_contents":142,"faqs":143,"seo_title":144,"seo_description":67,"update_tm":145,"read_time":146,"preview_page_count":4},549758252649,"https://ap-avatar.wpscdn.com/avatar/8000253669c5317157?_k=1778319167496531819","Informatics in Education, 2026, Vol. 25, No. 2, 167–203 167  \n© 2026 G. Sarmento, M.J.C.S. Reis. Published by Vilnius University and Tallinn University. DOI: [https://doi.org/10.15388/infedu.2603.031](https://doi.org/10.15388/infedu.2603.031)  \nThe Pedagogical Role of Source Code Comments in Programming Education: A Qualitative Systematic Review with Layered Evidence  \nGonçalo SARMENTO 1 , Manuel J. C. S. REIS2,∗  \n1 Quinta de Prados, Vila Real, Universidade de Trás-os-Montes e Alto Douro, Portugal  \n2 Quinta de Prados, Vila Real, Departamento de Engenharias & IEETA, Escola de Ciências e Tecnologia, Universidade de Trás-os-Montes e Alto Douro, Portugal  \n[e-mail: al82369@alunos.utad.pt](e-mail: al82369@alunos.utad.pt), [mcabral@utad.pt](mcabral@utad.pt)  \nAbstract. 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.  \nKey words: source code comments, programming education, program comprehension, self-explanation, metacognition, qualitative systematic review.  \n1. Introduction  \nLearning to program remains a cognitively demanding process, particularly for novice learners, who must simultaneously coordinate syntax, semantics, control flow, abstraction, and problem decomposition while translating informal reasoning into executable representations (Navarro-Cota et al., 2025; Shi, 2021). This complexity helps explain why introductory programming continues to be associated with persistent learning difficulties,  \n∗Corresponding author.  \n168 Sarmento and Reis  \nespecially in early stages of study, and why programming education research has increasingly emphasized instructional designs that reduce extraneous cognitive load and make code more interpretable (Tsai et al., 2025; Shi, 2021) .  \nA growing body of work in computing education has therefore focused on supports that improve program comprehension, debugging, and reflective reasoning, since these dimensions are foundational to successful programming performance (Yang et al., 2024 ; Shi, 2021) . In this context, source code comments occupy an interesting and potentially underexplored pedagogical space. In professional software development, comments are typically discussed as documentation artifacts that support readability, maintainability, collaboration, and long-term comprehension of software systems (Rani et al., 2023; Figlet al., 2025) . However, in educational settings, comments may also function as instructional and metacognitive scaffolds: they can help learners articulate intent, externalize reasoning, connect individual lines of code to higher-level goals, and make problem-solvi","cbCaidF0zTo5hY0Y","https://ap.wps.com/l/cbCaidF0zTo5hY0Y","pdf",329299,37,"English","# 1. Introduction\n# 2. Background and related work","[{\"question\":\"How does the review define the pedagogical role of source code comments in programming education?\",\"answer\":\"It frames comments as more than documentation artifacts, treating them as scaffolds that can support learners’ explanation, intent clarification, and reflective reasoning during code interaction.\"},{\"question\":\"What method and evidence structure does the article use?\",\"answer\":\"The article uses a PRISMA-informed qualitative systematic review with layered synthesis, based on searches in Scopus and ERIC and subsequent organization into primary synthesis, supporting/contextual, and exclusion sets.\"},{\"question\":\"What learning outcomes does the review associate with comment-based supports?\",\"answer\":\"Findings suggest comments can support explanation-centered learning, particularly for code comprehension, self-explanation, debugging, reflective reasoning, and formative assessment of students’ thinking.\"}]","The Pedagogical Role of Source Code Comments in Programming Education - A Qualitative Systematic Review with Layered Evidence | PDF",1792033306,93]