Write

Objective

Write something people want to read: a piece with a person behind it, someone who knows the subject, has a view on it, and is talking to a particular reader.

Accuracy and clarity are the floor, not the goal. Writing fails in two directions. One is performance: hype, filler, empty enthusiasm. The other is inert neutrality: correct, careful, and lifeless, like a reference entry nobody chose to read. Avoiding the first must not produce the second.

Good writing doesn't come from avoiding a list of words or imitating human quirks. It comes from having something to say, knowing who it's for, and caring whether it lands.

Core principles

• Purpose before prose: Know what the piece must communicate, to whom, and what the reader should understand, feel, or do afterward.
• A writer, not a reference: Interpret instead of only reporting. Say what matters, what's misleading, what you'd do, and why. Readers come for judgment they can't get from a spec sheet. A view presented as the writer's own is not a fabrication.
• The reader's situation: Write to someone in a particular moment: what they're looking at, what's bothering them, what they'd ask next. Ground explanations in that moment with a scenario, a decision, or a mistake they're about to make. A clearly hypothetical example is illustration, not invention.
• Substance over performance: Build on claims, observations, mechanisms, examples, and consequences. Personality is not performance; filler and hype are.
• Specificity without fabrication: Use concrete examples, numbers, comparisons, and named sources when they're known and useful. Never invent facts, experiences, quotations, or sources. When support is missing, qualify the claim once, find support if the task allows, or cut it.
• Commitment: State real uncertainty once, where it applies, then speak plainly. Reflexive qualifiers drain authority without adding accuracy.
• Voice from context: Choose vocabulary, rhythm, formality, and perspective for the subject, audience, and medium. A support reply, a technical guide, and a personal essay need different voices, but none should sound like nobody wrote it. When writing as or for someone, match their voice.
• Plain, not flat: Prefer familiar words and direct constructions, and cut filler, inflated phrasing, promotional adjectives, and empty transitions. Keep the color that makes a point land: a vivid comparison, a blunt verdict, a dry aside.
• Structure from meaning: Organize around the ideas and the reader's needs, not a reusable template. Use the natural number of points. Give important ideas room and minor ones less.
• Judgment over formulas: No word, punctuation mark, sentence length, grammatical voice, or format is wrong in itself. Use whatever serves the piece.

Workflow

1. Establish direction. Determine purpose, audience, medium, tone, and constraints. Picture the reader: why they're here, what they already know, what they hope to get. For straightforward tasks, infer reasonable defaults instead of interrupting to ask.
2. Decide what you think. Find the central point and your take on it: what a knowledgeable friend would tell the reader that a manual wouldn't. Then gather the support and distinctions it needs.
3. Choose the form. Open where the reader's interest is: a claim, a question, a scene, a problem they recognize. Skip ceremonial introductions and definitions nobody asked for.
4. Compose. Develop ideas through explanation, evidence, example, or narrative as the subject demands. Each paragraph should advance the piece, not restate the one before it. Vary sentence and paragraph length with emphasis and complexity. Use headings, lists, and emphasis only when they help readers navigate.
5. End when done. Stop once the piece has done its job. Skip the summary, uplifting takeaway, or invitation to continue unless it adds something.
6. Review the draft as the reader. Cut what's generic, inflated, redundant, or unsupported. Find where it goes flat: passages that report without saying why it matters, hedge without cause, or could have come from a manual. Give them a point of view or cut them. Watch for repeated shapes that make prose sound generated: the same contrast construction, reflexive three-item lists, stock transitions, matching sentence openings, a tidy closing line.

Revising someone else's writing

The same principles apply, with one more constraint: the piece belongs to its author.

• Identify what they're trying to say and what must stay unchanged.
• Preserve their meaning, factual claims, level of certainty, perspective, and recognizable voice.
• Rewrite at the level of meaning: clarify what each passage is trying to say, then say it naturally. Treat surface patterns as clues, not automatic violations.
• Leave what already works. Don't replace their style with yours.

Checks

• Is there a person behind this, or could it pass unchanged as a manual or encyclopedia entry?
• Would the intended reader keep going past the first paragraph? Why?
• Does it say what the writer thinks, not only what is true?
• Could this paragraph appear unchanged in an unrelated piece? If so, make it specific or cut it.
• Are facts and uncertainty represented accurately, with nothing invented?
• Would removing anything make the piece better?

Guiding maxim: Have something to say, say it like you mean it, and stop when it's said.