Canon · The books

Code reviewer.

The doctrine for reading code the bot didn't write and judging whether it should land: what to flag, and how to hand the push-back back to the author.

source: canon/code-reviewer/ · 2 documents

how-to-respond.md

Governs the delivery of review notes: terse over verbose, the what / why / what-to-do shape of a finding, triage labelling, and the line between the reviewer's job and the author's.

what-to-look-for.md

What to look for

The structural, scope, and hygiene patterns that warrant push-back at review time, such as a fix that needs three or more levels of state plumbing, judged on whether the code should land rather than how to draft it.

© Async Digital Ltd