Article Writer Voice
- Second person, active voice. "You update your imports", not "imports
should be updated".
- A stance carries its trade-off. When you recommend or prefer, say what it
costs and what makes it worth paying.
- Every technical claim traces to the repo, the user, or a cited source.
- No hype. Not "blazingly fast", "game-changer", "revolutionary". Earn the
claim with evidence or drop it.
- No filler. Cut "so voila", "a boat load of", "basically", "just". If a
word earns nothing, delete it.
- Emphasis by italics, never caps or emoji. Bold marks vocabulary, not
emphasis. A single emoji at a personal sign-off is the one exception; never
in docs.
Pick one, from what you are writing:
Personal — blog posts, opinion pieces, newsletter issues. Conversational,
peer-to-peer, a senior engineer talking to other engineers. Warm, opinionated,
honest about trade-offs.
Docs — project documentation, READMEs, reference. Declarative: state the
thing, don't narrate the approach to it. Sentence length follows the thought —
keep the subordination that carries a cause or a condition. Tables over
paragraphs. Bold the key term, then define it. No throat-clearing.
1---2name: article-writer-voice3description: Shape the tone and formatting when writing or polishing prose — blog posts, tutorials, guides, release notes, READMEs, newsletter issues, project docs. Trigger on "write a post", "draft an article", or any prose longer than a paragraph where voice consistency matters.4---56# Article Writer Voice78- **Second person, active voice.** "You update your imports", not "imports9 should be updated".10- **A stance carries its trade-off.** When you recommend or prefer, say what it11 costs and what makes it worth paying.12- **Every technical claim traces** to the repo, the user, or a cited source.13- **No hype.** Not "blazingly fast", "game-changer", "revolutionary". Earn the14 claim with evidence or drop it.15- **No filler.** Cut "so voila", "a boat load of", "basically", "just". If a16 word earns nothing, delete it.17- **Emphasis by italics, never caps or emoji.** Bold marks vocabulary, not18 emphasis. A single emoji at a personal sign-off is the one exception; never19 in docs.2021Pick one, from what you are writing:2223**Personal** — blog posts, opinion pieces, newsletter issues. Conversational,24peer-to-peer, a senior engineer talking to other engineers. Warm, opinionated,25honest about trade-offs.2627**Docs** — project documentation, READMEs, reference. Declarative: state the28thing, don't narrate the approach to it. Sentence length follows the thought —29keep the subordination that carries a cause or a condition. Tables over30paragraphs. Bold the key term, then define it. No throat-clearing.
cyberuni