Field Notes
Observational and dated. First person, specific, and deliberately unfinished.
The feeling Honesty about not knowing yet.
- median sentence
- 14
- you
- 5%
- hedges
- 18%
Write it down before you understand it. The value of a note is that it was taken at the time. Waiting until it makes sense produces a different document, usually a worse one, and always a later one.
Written from instinct. Nobody has counted this one against real
texts, so its figures are estimates and it names no failure modes. Treat it as a
sketch.
Open the rules
Rules
- Date everything
- First person, and say what you did
- Record the wrong turn
- Hedge honestly
- Leave it rough
Never
- Retconning. Do not rewrite yesterday's note to match today's understanding; write a new one.
- A conclusion the evidence does not support yet.
- Deleting the thing that turned out wrong.
Read the whole file
Plainspoken
Concrete nouns, working verbs, no throat-clearing. Varied hard, because uniform length is the tell.
The feeling Conviction, and the calm of somebody who does not need to convince you.
- median sentence
- 15
- sd / mean
- 0.55
- longest
- 45
- under 6 words
- 30%
- hedges
- 10%
Vary hard. Variance is the register, not shortness.
Open the rules
Rules
- Concrete over abstract
- Let the meaning choose the word
- Keep the hedge that carries a fact
- Do not chop at the conjunction
- No throat-clearing
- The short sentence is the verdict
Never
- Em dashes.
- "Not X, it is Y." Say Y.
- A summary of what the reader just read.
- Adjectives standing in as instructions.
- Explaining to readers what they obviously are, or why they are here.
- Restating a claim in different words to be sure it landed. See below: that is where condescension actually comes from.
How pastiche fails
- The variance collapse.
- One subject, one shape, three times.
- Mechanical de-Latinising
- Hedge-stripping
Detection standard deviation over mean, below 0.35. And three consecutive sentences opening with the same word, unless it is deliberate anaphora, which is distinguishable because deliberate anaphora runs three or more with escalation rather than two by accident.
Measured from Orwell, Hemingway, GOV.UK content guidance, digital.gov, Butterick, Paul Graham, and Pullum's criticism of Strunk and White
Read the whole file
The Argument
Essayistic. Wide variance, concession before the strongest claim, and an ending that never summarises.
The feeling The pleasure of watching somebody think, and change their mind on the page.
- median sentence
- 18
- mean sentence
- 21
- sd / mean
- 0.7
- longest
- 90
- under 6 words
- 28%
- hedges
- 15%
Make claims as strong as they can be made without becoming false. Graham's dial, and the whole register in a sentence. Weaker than that and the essay is not worth reading. Stronger and it is not worth trusting.
Open the rules
Rules
- Variance carries the argument
- Keep the qualifier, and pick the right one
- Concede before the strongest claim, never after
- The thesis may move, and that movement is the essay
- Move downward, from the general to the particular
- Brevity is the diction of command
Never
- Never restate the argument at the end. The conclusion-that-recaps is a vestige of legal rhetoric, where it was the closing remarks to a jury, surviving in a form whose purpose is not persuasion.
- Never peter out. The failure Graham names is starting on the most radioactive question and then recoiling from it, ending on "one thing is certain: the question is a complex one."
- Never ask a rhetorical question you do not then answer with a fact.
- Never say "clearly" or "obviously". If it were, the sentence would be unnecessary.
- Never build a strawman. It costs more credibility than it wins.
- Never digress without paying for it. Digression is licensed, but under a constraint: the essay owes the reader something they did not already know.
How pastiche fails
- claim-altitude with no evidence under it
- The aphorism with no referent.
- The unearned "we".
- The colon that promises depth
- "Not X but Y", saturated.
- The escalating tricolon.
- The summary ending in disguise.
Detection count the sentences making a general claim with no number, name, date or object in them. In the measured essays that ratio is low and clusters at section ends. Uniform across the text, the piece is intoning rather than arguing. Then, for each general sentence, ask what specific observation produced it. If there is none, it is decoration.
Measured from Orwell, Didion, Baldwin, Paul Graham, McPhee, Pullum, Zadie Smith, Hitchens
Read the whole file
The Broadsheet
Wire news. Most important fact first, every claim sourced, and "said" is the only verb.
The feeling None, on purpose. Know that before choosing it.
- lede ceiling
- 30
- adjectives / noun
- 2
- median sentence
- 18
- you
- 0%
- hedges
- 2%
Every claim is sourced, and the sourcing verb is "said". Not "according to", not "revealed", not "noted". Reuters: those verbs "all contain an element of judgment by the reporter."
Open the rules
Rules
- Count the words in the first sentence
- News first, source second, unless it is contentious
- Two adjectives, then rewrite
- Days of the week, never yesterday
- Give the actor
- Never adopt the subject's framing
- Numbers, and repeat the surprising ones
Never
- Never put opinion in a news story. Features get no exemption.
- Never leave a claim unattributed. Contentious statements are re-sourced every time they appear, and "alleged" is not a substitute for a source.
- Never use a judging adjective or adverb: a hard-line speech, a glowing tribute, a staunch conservative.
- Never use an unverifiable superlative: unique, unprecedented, first, only, largest, record. If somebody else claims it, attribute the claim to them.
- Never read minds. "To write that someone hinted, implied, indicated, suggested, or signaled is to interpret someone's thoughts. This is rarely acceptable."
- Never qualify a denial. No "flatly denied", no "categorically denied", unless it is inside a quote.
- Never use journalese: reportedly, probe, dubbed, slammed, massive, embattled, oil-rich, looks set to, hit by fears that.
- Never use euphemism. "Died of cancer", not "passed away after a fight with cancer".
- Never alter a quotation, even to fix grammar.
- Never boast about your own reporting.
- Never begin with a question. "The audience wants to be informed, not take part in a quiz."
How pastiche fails
- Journalese standing in for reporting.
- The sympathetic attribution verb.
- The unattributed background paragraph.
- The lede that summarises rather than reports.
- Adopting the subject's own name for the thing.
- The unverifiable superlative, unattributed.
- Mind reading.
- The pyramid shape with an argument inside it.
Detection count the adjectives and adverbs that could not be checked by a third party, then count the sentences with no attribution. In wire copy the first number is near zero and the second is near zero. Either one rising is the writer becoming visible.
Measured from Reuters Handbook of Journalism, AP Statement of News Values, BBC News Styleguide, The Economist Style Guide
Read the whole file
The Catalogue
Dense. Every sentence a fact, no connective tissue, nothing said twice.
The feeling None, on purpose. It is a surface to scan.
- median sentence
- 9
- you
- 0%
- hedges
- 0%
Every sentence is a fact, and no fact appears twice. This register is a reference to be scanned, not read. Repetition is not emphasis here, it is noise in a place where the reader is looking for one specific thing.
Written from instinct. Nobody has counted this one against real
texts, so its figures are estimates and it names no failure modes. Treat it as a
sketch.
Open the rules
Rules
- Facts, not sentences about facts
- Parallel structure, always
- No connective tissue
- Absent is a value
- Order by what is looked up
Never
- A sentence whose only job is transition.
- An adjective standing in for a measurement.
- Prose paragraphs. If it needs one, it belongs on a different page.
- Personality of any kind.
Read the whole file
The Manual
Reference writing. Imperative, second person, no personality, complete before readable.
The feeling None, on purpose, and for a reader who is already frustrated.
- median sentence
- 12
- you
- 45%
- hedges
- 2%
Complete beats readable. A reference page is not read, it is consulted, by somebody who already has a problem. Leaving out an edge case to keep a paragraph tidy fails the one person who came looking for that edge case.
Written from instinct. Nobody has counted this one against real
texts, so its figures are estimates and it names no failure modes. Treat it as a
sketch.
Open the rules
Rules
- Tell them what to do
- One instruction per step
- Say what happens next
- Name the failure and the fix together
- No voice
Never
- A preamble before the steps.
- "Simply", "just", "easy". If it were, they would not be reading this.
- A cross-reference where the answer would fit. Say it twice rather than send them away.
- Explaining why before saying what. The why goes after, for the reader who wants it.
Read the whole file
The Teacher
Explains. Names the confusion before it happens, and bounds every analogy before the reader over-extends it.
The feeling Warmth, and the specific relief of being taken seriously.
- median sentence
- 22
- variance
- high
- you
- 14%
- we
- 38%
- hedges
- 20%
Describe the material, never the reader's mind. This is the whole diagnostic for condescension, and it fits in a sentence.
Open the rules
Rules
- Long sentences, varied hard
- Three pronouns, three jobs
- The name arrives after the thing
- Name the confusion as a fact, not a question
- Predict the wrong inference, then cancel it
- Every analogy carries its own expiry
- Reassurance must be attached to a fact
- Say where every claim stands
- Retract the scope at the end
Never
- "Just". A filler that presumes a background. Usually deletable with no loss of meaning.
- "Simply", "easy", "trivially", "of course", "everyone knows", "as you'd expect". All share one mechanic: they assert the reader's mental state, so a reader who is stuck is told in passing that being stuck is anomalous.
- "Obviously" and "clearly" aimed at the reader. One licensed exception, from Halmos: you may call something obvious to place it in perspective, and if you do, make sure the obvious thing is true. Nielsen's only real use of it is aimed at his own model. Point it at your own claim, never at the reader's comprehension.
- Tag questions. "Makes sense?", "See?", "Pretty simple, right?" Each demands assent and offers no way to withhold it.
- A rhetorical question you answer yourself in the next clause. It stages a dialogue the reader is not in.
- Bluffing. Halmos: readers sense concealment, and they blame neither the facts nor themselves. They blame the author, correctly.
- An unbounded analogy, or one quietly doing a second job it was not introduced for.
- Simplifying the vocabulary below the reader's level. It buys nothing, measurably.
How pastiche fails
- no more accurate
- The collective pronoun misused.
- Reassurance with no content.
- Uniform short sentences.
- Enthusiasm standing in for structure.
- The analogy that is never taken away.
- Warm tone, expert sequencing.
Measured from Feynman, Sagan, Bartosz Ciechanowski, Michael Nielsen, Grant Sanderson, Bret Victor, Paul Halmos, Julia Galef
Read the whole file