Example nit comments
| Example | What it means |
|---|---|
| nit: typo in the comment, “recieve” → “receive”. | Fix the spelling, not blocking |
nit: maybe rename data to orders? | A clearer name is suggested |
| nit: extra blank line here. | Formatting only |
| nit (non-blocking): could use a constant for 30. | Optional improvement |
| Nit, feel free to ignore: I'd move this import to the top. | Clearly optional |
| Not a nit: this will throw if the list is empty. | Blocking, must be fixed |
How to reply to a nit
| Example | What it means |
|---|---|
| Good catch, fixed. | You applied it |
| Done in the next commit. | You will apply it |
| I'll leave this one as is, since we use this name elsewhere. | Polite no |
| Let's tackle this in a follow-up PR. | Later |
Labels that work with nit
Conventional Comments, a common format, adds labels like nit:, suggestion:, question: and issue: so the author knows what blocks the merge. Google's code review guide also recommends marking optional comments as “Nit:” (Google engineering practices).
Related: LGTM meaning, PTAL meaning, code review comment examples.
Learn the phrases, not just the words
Devlingo, Gambit Studio's English for developers app, has over 3,600 phrases for daily standups, code review, Slack, email, meetings and pull requests, ten new ones a day with real context and pronunciation, and a widget with the phrase of the day.