Code Reviews & Technical Feedback

B2 · Upper-intermediate1 hr 6 minIT & TechnologyLesson 4 of 8 · Outline

Aims

Goal: give code-review feedback that improves the code without bruising the author — observe, reason, suggest, classify — and push back gracefully when you're the author.

The lesson, stage by stage

  1. Warm up5 min

    Warm-up: The comment under the code

    2 warm-up questions

  1. Reading10 min

    Reading: The Language of Code Reviews

    Read a 215-word text about The Language of Code Reviews

  2. Vocabulary8 min

    Vocabulary: Code Review Vocabulary

    7 items

  3. Framework6 min

    Framework: Constructive Code Review Framework

    Constructive Code Review, 4 steps

  4. Reading10 min

    Reading: A model review thread, out loud

    Read a 272-word text about A model review thread, out loud

  5. Practice7 min

    Practice: Match Review Comments to Tone

    Matching exercise, 5 items

  6. Dialogue10 min

    Dialogue: Discussing a Code Review

    Role-play: You're reviewing a colleague's pull request and discussing your feedback (6 lines)

  7. Discussion10 min

    Discussion: Your mission: review and be reviewed

    3 discussion questions

Open the full lesson

The remaining 7 stages of this lesson, with the procedure, the examples and the exercises, are included with Starter, along with the interactive version you can teach from. Lesson 1 of this course is free: the full plan is on this site, and a free account opens it in the interactive player.

Start with lesson 1, freeSee Starter pricing

Target vocabulary

In a Tuton account these words become your student's vocabulary deck, so they come back in practice between lessons.

pull requestrefactorcode smelltechnical debtscalablebest practiceedge case

This plan comes from the Tech Workplace Communication course in the Tuton library. Browse all free lesson plans.