2024-09-21

What mentor markup actually teaches in code review

By Chris Lert

Illustration for What mentor markup actually teaches in code review

Learners often assume mentors hunt for cleverness. In practice, Bridgemesh reviewers spend most ink on naming, boundaries, and failure transparency. A variable called data2 tells everyone you rushed; a function called reconcile_uploads tells colleagues where to look when invoices break.

We annotate diffs with questions instead of edicts when possible: what breaks if this token expires? who runs the rollback command? The goal is judgment transfer, not gatekeeping.

Negative space matters. Sometimes the best review is deleting code—removing a redundant try/except that swallowed context. Learners keep a “mentor phrasebook” in Notion to translate shorthand into action items.

Reviews are not instant. Cohort SLAs explain turnaround windows so anxiety does not become another bug.

Tags: mentorship · reviews · culture