{"schemaVersion":1,"record":{"key":"mechanic/education--peer-review","type":"mechanic","id":"education--peer-review","lang":"en","title":"Peer review and revision","summary":"A peer checks another solution against criteria, explains feedback and suggests a fix. The author revises the result and checks the change.","updatedAt":"2026-10-22","status":"active","url":"https://gamemechanics.pro/en/knowledge/mechanic/education--peer-review/","jsonUrl":"https://gamemechanics.pro/api/v1/knowledge/en/mechanic/education--peer-review.json","markdownUrl":"https://gamemechanics.pro/content/knowledge/en/mechanic/education--peer-review.md","aliases":["Peer review"],"tags":["Educational games","Applied learning and evidence work"],"sourceIds":["source-76cfa0e9f5046b57"],"sources":[{"id":"source-76cfa0e9f5046b57","title":"GitHub / Visual Studio Code","url":"https://docs.github.com/en/pull-requests/how-tos/review-pull-requests/reviewing-proposed-changes-in-a-pull-request","verifiedAt":null}],"sections":[{"id":"principle","title":"How it works","body":"Players assess another solution against criteria, give actionable feedback and evaluate the revision."},{"id":"variants","title":"Variants","body":"### Variants\n\n<a id=\"peer-review-variants\"></a>\n\n- Apply the same rubric to two submissions <a id=\"peer-review-1\"></a>\n- Identify the specific location of an error <a id=\"peer-review-2\"></a>\n- Distinguish an error from a valid alternative method <a id=\"peer-review-3\"></a>\n- Support feedback with an example or check <a id=\"peer-review-4\"></a>\n- Suggest a correction without replacing the author’s work <a id=\"peer-review-5\"></a>\n- Revise a solution after receiving feedback <a id=\"peer-review-6\"></a>\n- Discuss rating disagreements against the criteria <a id=\"peer-review-7\"></a>\n- Compare original and revised versions <a id=\"peer-review-8\"></a>"},{"id":"example","title":"Design example","body":"Hypothetical engineering team: review another player’s bridge design and propose a testable improvement."},{"id":"context","title":"Context and limits","body":"A mechanic map for games with explicit learning goals, from first encounters with a topic to professional practice. It covers children, teenagers and adults; choose subject, difficulty, context and controls for the learner. Player actions, subject content, instructional support and assessment are distinct layers. Scores and game completion alone do not establish mastery or skill transfer."}],"relations":[],"placements":[{"catalogId":"education","id":"peer-review","title":"Educational games","url":"https://gamemechanics.pro/en/mechanics/education/#peer-review","categoryIds":["applied-learning"]}],"supersededBy":[],"attributes":{"preview":{"updatedAt":"2026-10-22","title":"Peer review","description":"A peer checks another solution against criteria, explains feedback and suggests a fix. The author revises the result and checks the change.","image":{"src":"images/mechanics/learning-github-suggestion.webp","width":1440,"height":803,"crop":{"x":641,"y":181,"width":788,"height":530},"game":"GitHub / Visual Studio Code","sourceUrl":"https://docs.github.com/en/pull-requests/how-tos/review-pull-requests/reviewing-proposed-changes-in-a-pull-request","originalUrl":"https://docs.github.com/assets/cb-122600/images/help/codespaces/review-suggestion.png","credit":"GitHub documentation contributors","rights":"© GitHub documentation contributors. Screenshot from GitHub Docs. Third-party application imagery; excluded from portal MIT and CC BY 4.0.","caption":"GitHub in VS Code: feedback on a code line with a suggested replacement","alt":"GitHub in VS Code: feedback on a code line with a suggested replacement","markers":[{"x":68,"y":56,"label":"The comment contains a specific suggested change"}]},"tips":["Link feedback to a specific location and a testable criterion."],"examples":[{"title":"GitHub / Visual Studio Code","url":"https://docs.github.com/en/pull-requests/how-tos/review-pull-requests/reviewing-proposed-changes-in-a-pull-request"}]}},"endsAt":null,"provenance":"Educational reference expanded from all 64 families and 749 variants of the original children-education taxonomy, with original editorial additions dated 2026-10-20. Sources support specific methods and examples, not the entire classification or its effectiveness.","license":"CC-BY-4.0","codeLicense":"MIT","attribution":"gamemechanics.pro contributors","catalogKey":"catalog/education"}}