Pull Requests That Get Reviewed Quickly

A
Author
13 Jun, 2026 1 min read 659 views

Slow reviews are usually a symptom of hard-to-review pull requests. You can make yours easy to say yes to.

1. Keep it small

Aim for changes a reviewer can understand in 15-20 minutes, often under a few hundred lines. Split big work into steps that each make sense on their own: refactor first, then the feature.

2. Write a description that answers the obvious questions

## What
Adds coupon codes to checkout (percentage and fixed-amount).

## Why
Marketing needs coupons for the Diwali campaign (#512).

## How
- New `coupons` table and `applyCoupon()` in the pricing service
- Validation: expiry date, minimum order value, one use per customer

## Testing
- Unit tests for pricing edge cases
- Manually tested in staging: screenshots below

## Notes for reviewers
The migration is backward compatible; the column is nullable.

3. Review it yourself first

  • Read the diff on GitHub as if you were the reviewer.
  • Remove debug logs, commented-out code and unrelated formatting changes.
  • Leave comments on tricky spots to explain your reasoning before anyone asks.

4. Make it easy to verify

  • Screenshots or a short video for UI changes.
  • Green CI before requesting review.
  • Clear steps to test locally, or a preview deployment link.

5. Handle feedback well

  • Reply to every comment, even with "Done" or a short explanation.
  • Push fixes as new commits during review so changes are easy to re-check; squash on merge if your team prefers.
  • Move long debates to a quick call, then summarise the decision in the PR.

For reviewers: respond within a working day, label comments as blocking or "nit", and approve when it's good enough, not perfect.

Was this article helpful?

Comments

No comments yet. Have a question or a tip? Be the first to share it.

Leave a comment

Comments are reviewed before they appear.