Writing PR descriptions reviewers actually read

A four-line template that gets your pull request reviewed in hours, not days.

Mai Nguyen

Frontend engineer · C1 · 6/9/2026 · 5 min read

Grammar

Career

The four-line PR template

What: one sentence describing the change.
Why: the bug, ticket, or decision behind it.
How: the trickiest part of the implementation.
Test: the exact steps a reviewer should run.

Reviewers don't want a wall of text. They want context that helps them decide in under a minute whether to dig deeper.

Discussion (3)

Mai Nguyen

Frontend engineer · C1

1d ago

Stealing the standup template. Thanks for sharing the actual sentences — that's what most posts skip.

Duc Hoang

Engineering manager · C1

1d ago

The "all green my side" line is gold. Going to use it tomorrow.

Khoi Tran

DevOps · B2

1d ago

Funny — I wrote a similar Notion-template post last month. Spaced repetition really is the unlock.

Mai Nguyen

@mai.codes

Frontend engineer · C1

In this post

The four-line PR template

How I started giving standups in English with zero anxiety

Baroo · 5 min read

Code review English that doesn't sound passive-aggressive

Mai Nguyen · 7 min read

More like this

Standup

Career

How I started giving standups in English with zero anxiety

Three sentence templates I memorised for yesterday / today / blockers, plus the phrases I steal from senior engineers.

Baroo

2d ago · 5 min read

124

Code Review

Grammar

Code review English that doesn't sound passive-aggressive

Soft phrases for tough feedback, plus how to receive a critique without sounding defensive.

Mai Nguyen

4d ago · 7 min read

211

Home

Learn

Saved

Writing PR descriptions reviewers actually read

The four-line PR template

Discussion (3)

Mai Nguyen

In this post

Related posts

More like this