Course · 9 lessons ~9 hr Intermediate

Code Review as Conversation

Give code reviews that improve the code without crushing the author. Receive reviews without defensiveness. Tag severity. Know when to convert a thread to a call. Review strangers' contributions in a way that brings them back. In a convention-strong ecosystem, review attention goes to deviations — the conventional thing needs no comment; the unconventional thing needs justification. That's a sharper bar than "this is suboptimal," and it's why a missing linter config masquerades as a code-review problem: if humans are commenting on quote styles, fix the upstream cause and reclaim the human review for human judgment. Watch also for what the diff doesn't show — callbacks, hooks, and framework magic that change what a small diff actually does; "what does this trigger downstream?" is the question that distinguishes reviewers who read diffs from reviewers who read systems. And remember the medium's physics: a review comment is a permanent, public, line-anchored payload with no tone channel. Engineer accordingly.

reading · we frame, you read MIT or the canonical taught · we author, no canonical fits ↺ spirals back to earlier lessons
Course locked

Complete Documents That Earn Their Place — READMEs, RFCs, ADRs, Postmortems, Memos first.

This course unlocks once you've finished its prerequisite. Open prerequisite →

9 lessons. Read in order; spiral back when you need to. By the end you'll have used the core ideas twice — once on the abstract, once on something you'll meet at work next week.