---
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
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
---
# Peer review and revision

id: education--peer-review
type: mechanic
key: mechanic/education--peer-review
lang: en
status: active
url: https://gamemechanics.pro/en/knowledge/mechanic/education--peer-review/

A peer checks another solution against criteria, explains feedback and suggests a fix. The author revises the result and checks the change.

## At a glance

![GitHub in VS Code: feedback on a code line with a suggested replacement](https://gamemechanics.pro/images/mechanics/learning-github-suggestion.webp)

[GitHub / Visual Studio Code](https://docs.github.com/en/pull-requests/how-tos/review-pull-requests/reviewing-proposed-changes-in-a-pull-request) · © GitHub documentation contributors. Screenshot from GitHub Docs. Third-party application imagery; excluded from portal MIT and CC BY 4.0.

1. The comment contains a specific suggested change

- Link feedback to a specific location and a testable criterion.

- [GitHub / Visual Studio Code](https://docs.github.com/en/pull-requests/how-tos/review-pull-requests/reviewing-proposed-changes-in-a-pull-request)

## How it works

Players assess another solution against criteria, give actionable feedback and evaluate the revision.

## Variants

### Variants

<a id="peer-review-variants"></a>

- Apply the same rubric to two submissions <a id="peer-review-1"></a>
- Identify the specific location of an error <a id="peer-review-2"></a>
- Distinguish an error from a valid alternative method <a id="peer-review-3"></a>
- Support feedback with an example or check <a id="peer-review-4"></a>
- Suggest a correction without replacing the author’s work <a id="peer-review-5"></a>
- Revise a solution after receiving feedback <a id="peer-review-6"></a>
- Discuss rating disagreements against the criteria <a id="peer-review-7"></a>
- Compare original and revised versions <a id="peer-review-8"></a>

## Design example

Hypothetical engineering team: review another player’s bridge design and propose a testable improvement.

## Context and limits

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.

## Connected materials


## Sources and 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.

- [GitHub / Visual Studio Code](https://docs.github.com/en/pull-requests/how-tos/review-pull-requests/reviewing-proposed-changes-in-a-pull-request) (id: source-76cfa0e9f5046b57)

CC-BY-4.0 · gamemechanics.pro contributors