code-review-tips is a concise, actionable set of heuristics to improve the quality and consistency of software code reviews. While examples are written in JavaScript, the advice generalizes to most languages and frameworks. The tips focus on spotting common pitfalls—naming ambiguity, hidden complexity, missing tests, leaky abstractions, performance traps, and security footguns—before they reach production. The guide is designed to be skimmed during review, turning tribal knowledge into a repeatable checklist. It champions empathetic reviewing, emphasizing clarity, small diffs, and constructive feedback that helps teams move faster. By treating code review as a skill with teachable patterns, the project helps teams catch issues earlier and raise the overall bar.
Features
- Language-agnostic review heuristics illustrated with JS examples
- Focus on correctness, clarity, testing, performance, and security
- Practical checklist mindset for faster, more consistent reviews
- Guidance on writing constructive, empathetic feedback
- Emphasis on small, well-scoped pull requests and readable diffs
- Useful as onboarding material for new reviewers and teams