A real pull request becomes a 32-second explanation with code, before-and-after behavior, and sound.
Make the request
Send the pull request and name the audience:Who needs to understand it?
- Users — lead with the visible change, show the before and after, and name any action they must take.
- Contributors — explain the architecture change, important tradeoff, and code path reviewers need to understand.
- Social audience — make one clear feature reveal with visible proof and only the implementation detail that explains it.
Before it builds
Confirm:- the intended pull request and audience;
- whether the angle is a changelog, feature reveal, fix, or refactor;
- whether the change is proposed, merged, or released;
- the visible before and after;
- any breaking change or migration step.
Verify the proof
- The pull request and target branch are correct.
- Proposed, merged, and released are not confused.
- User-facing claims match the actual behavior.
- Code excerpts show only the relevant lines and remain readable.
- Tests and refactoring are not presented as product features.
- Contributor names and release details are accurate.
Finish and share
Check the final project, render through your preferred surface, and review the file.