Changelog from raw commit history
writingGroups commits into user-facing changes, without inventing anything that is not in the log.
Rewrites button labels, errors, and empty states so they say what happened and what to do.
Before shipping a flow, or when support tickets show people misreading the UI.
Audit the interface copy below.
For each string, decide whether it states:
- what happened, and
- what the person can do next.
Rewrite only the strings that fail. Keep the meaning identical; change nothing about the feature.
Rules:
- Buttons: verb plus object ("Save draft", not "Submit").
- Errors: what failed, why if known, and the next action. Never apologise and never blame the user.
- Empty states: say what will appear here and how to make it appear.
- No exclamation marks, no "Oops", no "Something went wrong" on its own.
Output a table: current string, problem, replacement.
Copy:
<strings>
Include the screen name next to each string — the same sentence needs different copy on a settings page and a checkout page.
The two-question test (what happened / what can I do) is mechanical enough to apply at scale, which is what makes an audit finishable.
Groups commits into user-facing changes, without inventing anything that is not in the log.
Turns what the product does into what it removes from the reader's day.
Turns logs and a chat transcript into a blameless postmortem with contributing factors, not a culprit.