The lesson
Put a one-line example of the feature working in most changelog sections, so the reader pictures their own use before reading the setup.
The move
A video at the top shows a prompt typed into a box: "@Linear create a loop that runs whenever a PR is merged". Sections like Slack and GitHub triggers and Custom loop templates each state what they do, then give a case, such as drafting a QA plan when a PR gets a "ready for testing" label.
Why it works
- Our readA concrete trigger like a GitHub label lets a reader decide in one line whether the update touches their workflow.
- Our readShort headed sections on a dark, quiet page make a five-item update easy to scan, so a reader can jump to the one item they care about.
What not to copy
Don't copy the Loops product vocabulary or assume readers know it. Keep the pairing of a short capability statement with one named, everyday example.
