# Writing Style

<!-- FLY-1138: moved here from AGENTS.md ("Writing Style"), which keeps a
     one-line conditional pointer. Read this before writing or editing copy;
     the human-writing skill covers the same ground in more depth. -->

When writing or editing any copy — product docs, marketing pages, website copy, wikis, etc:

- Write like a sharp colleague, not a brochure. Clear, confident, human.
- Active voice by default. "We built X" not "X was built to enable..."
- Vary sentence rhythm. Short sentences land. Longer ones can unpack an idea when needed.
- Kill corporate filler: "leverage", "utilize", "facilitate", "in order to", "it should be noted that", "best-in-class", "robust."
- Use "you" and "we" naturally. Talk to the reader, not past them.
- Technical accuracy matters — but explain concepts plainly before going deep.
- No emoji. No exclamation marks. No hype. Let the product speak through clarity, not enthusiasm.
- Prefer concrete over abstract. "Cuts deploy time from 20 minutes to 3" beats "dramatically accelerates deployment workflows."
- One idea per paragraph. If a sentence doesn't earn its place, cut it.
- Don't repeat the same stat or claim more than once per page. Cross-page repetition is fine — readers land on individual pages.
- When differentiating, name what the alternative does and where it falls short. Don't just assert we're better — show the specific gap.