Code review speaking principles
  • Code, not author: "This function could be simplified" not "You wrote this wrong"
  • Explain the why: "I'd suggest X because it reduces coupling" — not just "change this"
  • Questions over commands: "Have you considered using a map here?" is gentler than "Use a map"
  • Acknowledge good work: Name specific things you liked before raising issues