economist-style

The Economist Style Guide

Apply these principles to all written content, including markdown files, HTML, code documentation, and technical writing.

Core Principles

1. Clarity first: Use short words, active voice, and concrete examples
2. Precision: Replace vague quantifiers with specific numbers and facts
3. Brevity: Choose concise over verbose expressions
4. Dialect awareness: Match the document's existing spelling and conventions (British, American, etc.)

Orwell's Six Elementary Rules

The guide's introduction rests on George Orwell's six rules (from "Politics and the English Language", 1946): clarity of thought first, then say it as simply as possible.

1. Never use a metaphor, simile or other figure of speech which you are used to seeing in print
2. Never use a long word where a short one will do
3. If it is possible to cut out a word, always cut it out
4. Never use the passive where you can use the active
5. Never use a foreign phrase, a scientific word or a jargon word if you can think of an everyday English equivalent
6. Break any of these rules sooner than say anything outright barbarous

Tone: The "Do Nots"

In the spirit of the guide's introduction:

• Do not be stuffy: Use everyday speech, not the language of lawyers or bureaucrats
• Do not be hectoring or arrogant: Those who disagree are not necessarily stupid; persuade with evidence, not assertion
• Do not be too pleased with yourself: Let analysis speak; avoid self-congratulation
• Do not be too chatty: Maintain professional distance
• Do not be too didactic: Guide, don't lecture
• Get straight in and be lucid: No throat-clearing openings; edit ruthlessly; cut anything superfluous

Analysis Workflow

When reviewing text, follow this sequence:

0. Load the Signature Rules

Read reference/ECONOMIST-SIGNATURE.md first — a one-page distillation of the rules that make copy recognizably Economist (numbers, dates, commas, quotes, honorifics, headings). Most reviews need only this plus the quick checks below; load the detailed files only when a deeper check is warranted.