Writing a code review comment in English that doesn't sound rude

Resposta esperada

Text loses tone, so English review culture leans on softeners and framing that can feel excessive to a Brazilian ear but read as normal there. Patterns: ask instead of command ("What do you think about extracting this?" / "Could we handle the null case here?" rather than "Extract this"); label severity so people can triage ("nit:", "suggestion:", "blocking:", "question:"); explain the why, not just the what ("This could throw if `items` is empty — maybe guard at the top?"); use "we"/"the code" not "you" ("this function" not "your function"); and acknowledge good things too. Avoid sarcasm and "obviously"/"just" — they read as condescending. When something is genuinely wrong, be direct but about the code: "This will double-charge on retry — we need an idempotency key" is fine; "why would you do this" is not.