HomeStandards

Standards

Readable prose standard

Problem this solves: the claim is sound and the data are correct, but readers cannot move through the paragraph. This standard governs breath, sentence craft, and citation layout i

Problem this solves: the claim is sound and the data are correct, but readers cannot move through the paragraph. This standard governs breath, sentence craft, and citation layout in body prose. Use it with book-standard.md (structural acceptance) and chapter-template.md (one-pager).

1. Means priority (what comes first) #

The primary means of fluency is whole-sentence rewriting: keep claim, data, and naming fixed; rewrite the sentence so it carries.
Deletion is secondary: remove only tour-guide words, zero-information restatement, and chaining dashes that block breath.

| Priority | Do | Do not treat as the main move | | --- | --- | --- | | 1 | Rewrite the sentence: clear subject, varied rhythm, information said once | Only delete words, only swap punctuation, chop long sentences into outline stubs | | 2 | Reorder inside the paragraph: scene/change → mechanism → name | Reorder the chapter's claims or change when terms are named | | 3 | Cut scaffolding: tour guides, empty restatement, packaging self-reference | Cut transitions and information to make the line "shorter" |

An earlier draft of this standard drifted into "prohibitions + deletion" because the don'ts were specific and the sentence craft was vague. This version puts whole-sentence rewriting first.

Acceptance target is fluency: the reader is carried through a passage.

2. Peer group #

This book is argumentative management nonfiction. Primary peer: bestselling nonfiction. Secondary: literary breath only.

| Peer | Samples | Steal | Do not steal | | --- | --- | --- | --- | | Primary: bestselling nonfiction | Crossing the Chasm, The Innovator's Dilemma, The Lean Startup, Zero to One; Gladwell / Kahneman-style | Scene → mechanism → name; short carry, long land; density; name when needed | Literary delayed naming; framework chapters as fiction; omit until unrestatable | | Secondary: literary breath | Median Nobel openings | Change/scene before the number; one landing line; less self-reference | Lyricism, stream of consciousness, magical juxtaposition |

3. When it applies #

Applies to reader-facing body prose: preface, chapter sections, and judgment-boundary narration. Does not apply to status lines, acceptance checklists, or internal editorial notes.

4. Whole-sentence rewriting (primary means) #

When a passage stalls, find the stuck sentence and rewrite it before deleting. Stuck sentences are usually too long, subject-adrift, dash-chained, tour-guide interrupted, or definition-led openings.

Rewrite under four rules:

  1. One job per sentence. Advance one piece of information; put turns in a new sentence instead of gluing with dashes.
  2. Show, then explain. Prefer change or scene over metric bulletin; mechanism follows visible fact.
  3. Short as floor, long as reward. Most sentences crisp; the complex sentence after short setup. Short is not telegraphic outline.
  4. Say the information once, completely. Keep numbers, names, and conditions; do not create "cleanliness" by deleting information. Merge synonymous restatement into one clear sentence rather than leaving a half-thought.

Whole-sentence rewriting may change wording and syntax. It may not change: claim truth-value, data and sources, case facts, or when a concept is named (unless the original naming was itself misplaced).

5. Five prohibitions (secondary: spot hard joins) #

Use the five prohibitions to diagnose. Treat with Section 4 rewriting first; delete only as support.

  1. Open like a bulletin
    Do not open by reading a chart or bare definition. Start with change or scene.
    Framework sections may use one orientation line before axes; if cutting leaves a naked definition, rewrite the orientation back—do not bare-delete.

  2. Stack slogans at one volume
    No same-intensity pull-quote runs. Long carry, short land; usually one landing line per paragraph.

  3. Replace story with inventory
    In narrative argument, no roll call in place of mechanism. Framework captions, Monday lists, and acceptance items may enumerate.

  4. Point at the bookshelf mid-argument
    Packaging only: title, part name, cover, table of contents.
    Not: main frame, axes, metric tables, how to read a sample hall.

  5. Glue clauses with em dashes
    When dashes stack or chain explanation/enumeration/turns, prefer splitting and rewriting sentences, then punctuation.
    Zero dashes is not an acceptance target.

6. Asides and forced metaphor #

  • Asides: tour-guide talk ("first, a number," "see below," "notice how this differs") should disappear by rewriting into a sentence that advances judgment, not by hollowing into an outline. Keep questions, information, and suspense.
  • Forced metaphor: if it does not stand, rewrite the sentence another way; do not strip the image and leave a stump.

7. Rewrite discipline #

  1. Primary means is whole-sentence rewriting; deletion alone cannot count as a complete fluency pass.
  2. Every edit should name which stuck-sentence pattern was rewritten, or which prohibition was hit; if neither, do not edit.
  3. Read aloud after: if worse, or more outline/bulletin-like, revert.
  4. No chapter overhaul for checklist theater (literary quotas, forced scenes, delayed naming, stripping framework orientation, zero-dash hunts).
  5. Focus one problem class at a time; do not reorder claims under a fluency banner.

8. Data and citation layout #

Cite with mainstream author–year parentheses (e.g. Jones & Nisbett, 1972):

  • Preferred: …about one two-hundred-and-eightieth of the prior level (Stanford HAI, 2025).
  • Forbidden: standalone "Source: …"; forbidden: methodological asides inside the cite.
  • Full institution/report title may expand on first deep chapter treatment; preface uses author–year only.
  • Report medians, not means; thin evidence gets in-sentence qualification.

9. Actions (self-check after a draft paragraph) #

  1. Was the stuck sentence rewritten whole, or were only a few words deleted?
  2. Does the first sentence show change, scene, judgment, or framework orientation—not a bare definition?
  3. More than one poster line in the paragraph?
  4. Is information complete (numbers, names, conditions still there)?
  5. Are dashes chaining clauses? After split-and-rewrite, does it read cleaner (not chasing zero)?
  6. Read aloud: smoother than before? Any place the reader must translate the author's intent?

10. Acceptance #

A finished prose passage must satisfy all of the following:

  1. It can be read straight through.
  2. The core claim remains restatable in one sentence; data checkable; sources locatable.
  3. Revision was primarily whole-sentence rewriting; prohibitions and aside rules hold; citations follow Section 8.

11. Boundaries #

  • Quotable-candidate lists, acceptance self-checks, and status lines need not be polished here.
  • Framework captions and Monday lists may enumerate.
  • Do not trade falsifiability for "literary" effect.
  • Do not treat novelist tools as methods-book optimization.
  • Whole-sentence rewriting is not synonym polish: new syntax that does not improve fluency does not count.

12. Revision triggers #

  1. Reader feedback across two or more chapters names a new hard join not covered here.
  2. Citation layout conflicts systematically with publication or on-site evidence labels.
  3. Fluency edits dilute claim sharpness or evidence quality.
  4. After edits, the chapter is harder to read / more outline-like, or the revision log is deletion-only with no whole-sentence rewrites (roll back and tighten Sections 1, 4, and 7).