Writing great PRs

A PR description is evidence. The reviewer sees the change working before reading a line of the diff.

Lean on the visual, not the prose. A picture is parsed at a glance where a paragraph has to be read, so anything you would explain in text, whether a flow, a shape, or a before and after, show instead.

Headings

This skill supplies the evidence and the prose. The headings come from the first source that applies: