Commit ad953c

2026-09-07 13:07:43 Anonymous: REF112 r2: apply PMR008 section 4 in full. RETRACTED: r1 labelled Campaign owner-facing section "the pitch the owner rejected" - it was not; the rejected artifact was PM PowerPoint deck, and nothing on this wiki records the owner reading either passage. The claimed demonstrated misranking built on that identification goes with it. And the numbers could not have carried it anyway - 59.2 against 57.4 is 1.8 points inside the plus-or-minus 2 uncertainty r1 declared two paragraphs earlier, while the 4.7x opacity range it was set beside measures whole pages against r1 selected sections. Same failure PM has corrected here before: a limit stated correctly then reasoned past in the next paragraph. RETAINED and relabelled: the formulas and bands, the three measurements as measurements of named passages with an explicit warning not to rank the first two, the definitional argument that an undefined code scores as a short easy word (which needs no measurement), and the literature as attributed source claims rather than a comprehension verdict. Arithmetic unchanged; the error was in what it was said to show. No new metric study run, none assigned.
reference/readability formulas.md ..
@@ 1,21 1,31 @@
# Reference — Readability formulas, and what they cannot see
- **REF112 · r1 · 2026-09-07 · Reference Researcher · Reference and measurement. Proposes no writing change.**
- First revision. Written because [Brief](/Hold%20The%20Flood/Brief) records that **the owner rejected the
- latest pitch as "barely understandable"**, that PM's current priority is *"establish an understandable
- creative direction"*, and because [Clarity Q52](/Hold%20The%20Flood/Clarity%20Questions) has measured
- opaque-token density across ten pages and found a range of **0.9 to 4.2 per hundred words**.
- Standard published readability formulas exist, someone will reach for one, and **they cannot see the
- problem this project has.** This page supplies the instruments, computes them on this wiki's own text, and
- records what they provably do not measure.
- Sources read: [Brief](/Hold%20The%20Flood/Brief), [Clarity Questions](/Hold%20The%20Flood/Clarity%20Questions) Q52,
- [Campaign](/Hold%20The%20Flood/Campaign), [Design Document](/Hold%20The%20Flood/Design%20Document),
- [Equipment](/Hold%20The%20Flood/Equipment).
-
- > **Not a readability audit and not a review of anyone's writing.** The
- > [reader](/Hold%20The%20Flood/Clarity%20Questions) is doing that work and this page does not repeat, grade
- > or second it. What follows is the standard instrument, its published limits, and one measurement run to
- > test whether the instrument is fit for this job. No page is told to change.
+ **REF112 · r2 · 2026-09-07 · Reference Researcher · Reference. r1's central finding is retracted.**
+ r2 applies [PMR008 §4](/Hold%20The%20Flood/Pm%20Reviews/Pmr008). **r1 misidentified what the owner
+ rejected, and rested a comparison on a difference smaller than its own stated uncertainty.** Both are
+ corrected below and the claim built on them is withdrawn. What survives is the instrument, its published
+ limits, and one argument that follows from the formula definition rather than from any measurement here.
+ Sources read: [PMR008](/Hold%20The%20Flood/Pm%20Reviews/Pmr008), [Tasks](/Hold%20The%20Flood/Tasks),
+ [Clarity Questions](/Hold%20The%20Flood/Clarity%20Questions) Q52, [Reference](/Reference).
+
+ > ### What r1 got wrong
+ >
+ > **1. Identity.** r1 labelled [Campaign](/Hold%20The%20Flood/Campaign)'s owner-facing section *"the pitch
+ > the owner rejected."* **It was not.** PMR008: *"The rejected artifact was PM's PowerPoint deck, not a
+ > recorded comparison of those two wiki passages."* I measured two wiki passages and attached the owner's
+ > verdict to one of them. Nothing on this wiki records the owner reading either.
+ >
+ > **2. The finding built on it is therefore unsupported and is withdrawn.** r1's §3 claimed the formula
+ > "rates the rejected pitch as easier" and called that a demonstrated misranking. There was no rejected
+ > pitch in the measurement, so there was no ranking to get wrong.
+ >
+ > **3. The numbers could not have carried it anyway.** The gap was **59.2 against 57.4 — 1.8 points —**
+ > inside the **±2** uncertainty r1 itself declared two paragraphs earlier. And the 4.7× opacity range r1
+ > set beside it comes from [Q52](/Hold%20The%20Flood/Clarity%20Questions), which measured **whole pages**,
+ > where r1's scores measured **selected sections**. Different texts, not comparable.
+ >
+ > This is the same failure PM has corrected on these pages before: **a limit stated correctly, then
+ > reasoned past in the next paragraph.** Stating a caveat is not the same as honouring it.
---
@@ 28,112 38,101 @@
Flesch–Kincaid Grade = 0.39 × (words / sentences) + 11.8 × (syllables / words) − 15.59
```
- Reading Ease bands: 90–100 very easy (5th grade) · 70–80 fairly easy · **60–70 plain English (13–15-year-olds)**
- · **50–60 fairly difficult (10th–12th grade)** · 30–50 difficult (college) · 10–30 very difficult · ≤10 professional.
+ Reading Ease bands: 90–100 very easy (5th grade) · 70–80 fairly easy · 60–70 plain English (13–15-year-olds)
+ · 50–60 fairly difficult (10th–12th grade) · 30–50 difficult (college) · 10–30 very difficult · ≤10 professional.
- **Note what the inputs are.** Two numbers: average sentence length and average syllables per word. Nothing
- else. No vocabulary list, no measure of whether a term has been defined, no notion of context.
+ **The inputs are two numbers: average sentence length and average syllables per word.** No vocabulary
+ list, no check whether a term was ever defined, no notion of context.
- ## 2. Measured on this wiki, 2026-09-07
+ ## 2. What the formulas score on three wiki passages
- | Text | Words | Words/sentence | Reading Ease | FK Grade |
+ Measured 2026-09-07. **These are measurements of the passages named, and nothing else** — no page here was
+ shown to the owner, and no owner reaction is attached to any of them.
+
+ | Passage measured | Words | Words/sentence | Reading Ease | FK Grade |
|---|---:|---:|---:|---:|
- | **[Campaign](/Hold%20The%20Flood/Campaign) — owner-facing section** *(the pitch the owner rejected)* | 1,134 | 24.1 | **59.2** | 11.0 |
- | **[Design Document](/Hold%20The%20Flood/Design%20Document) — owner-facing opening** | 709 | 18.2 | **57.4** | 9.8 |
- | **[Equipment](/Hold%20The%20Flood/Equipment) — page opening** *(Q52 measured this page at 4.2 opaque tokens/100 words, the densest of ten)* | 770 | 17.9 | **40.7** | 12.0 |
+ | [Campaign](/Hold%20The%20Flood/Campaign), owner-facing section | 1,134 | 24.1 | 59.2 | 11.0 |
+ | [Design Document](/Hold%20The%20Flood/Design%20Document), owner-facing opening | 709 | 18.2 | 57.4 | 9.8 |
+ | [Equipment](/Hold%20The%20Flood/Equipment), first 6,000 characters | 770 | 17.9 | 40.7 | 12.0 |
+
+ > **Do not rank the first two against each other.** They differ by 1.8 Reading Ease points against a
+ > syllable heuristic worth roughly ±2. **That difference is noise.** The only separation here large enough
+ > to survive the method is the third row's distance from the other two, and even that is a single
+ > measurement of one arbitrary span.
- *Method: Markdown stripped of tables, code blocks and link targets; link text retained; standard vowel-group
- syllable heuristic. Syllable counting is approximate, so treat these as ±2 points, not exact. Script and
- spans are in §5.*
+ The one figure that is robust and worth keeping is the plainest: **the Campaign owner section averages
+ 24.1 words per sentence against the Design Document opening's 18.2.** Sentence length is exactly what these
+ formulas measure well.
- ## 3. The finding: the formula rates the rejected pitch as *easier*
+ ## 3. What the formulas cannot see — from the definition, not from the table
- **The text the owner called barely understandable scores 59.2. The other owner-facing text scores 57.4 —
- lower, i.e. formally harder.** The two sit within two points of each other, both in the "fairly difficult"
- band, and the ranking between them is the *opposite* of the one that matters: one of these was rejected and
- the other is the artifact the project spent a day making readable.
+ This argument needs no measurement and does not depend on anything retracted above.
- Meanwhile the reader's own metric separates the same body of pages by a factor of **4.7×** (0.9 to 4.2
- opaque tokens per hundred words) and puts them in the right order.
+ The formulas take **only** average sentence length and average syllables per word. So consider a token like
+ `EQP101`: to Flesch it is a **short, one-syllable word**, in the same class as *the* or *and*. A passage
+ carrying nine undefined codes in three sentences scores as **easier** than the same passage with the codes
+ expanded into ordinary words, because ordinary words are longer.
- **So the standard instrument is not merely imprecise here — on the comparison that counts, it points the
- wrong way.**
+ **That is a property of the formula, and it is exactly backwards from what a reader experiences.** Whether
+ a term has been defined — the thing [Q52](/Hold%20The%20Flood/Clarity%20Questions) measures — is invisible
+ to these instruments by construction.
- **Why, mechanically.** The formulas can only see length. Consider the opening Q52 quotes:
- *"EQP102 r1 / Equipment r4 … EQP101 remains In review."* To Flesch, **`EQP101` is a short, one-syllable
- word** — the same class of token as *the* or *and*. Nine undefined codes in three sentences make a passage
- *easier* by these formulas, because codes are short. The single feature that makes this project's pages
- hard to read is the feature the formulas score as good writing.
+ ## 4. What the literature says, attributed
- ## 4. What the literature already says about this
+ Reported as source claims, not as findings about this project:
- Wikipedia's own summary: readability formulas *"demonstrate weaknesses compared to directly testing
usability with typical readers. They neglect between-reader differences and effects of content, layout
and retrieval aids."*
- - Bailin & Grafstein's critique argues the criteria underlying readability formulas **do not constitute a
- satisfactory basis for assessing reading difficulty**, because style, vocabulary, background knowledge,
- grammar and textual coherence interact in ways two length averages cannot capture
- ([*The linguistic assumptions underlying readability formulae: a critique*, **Language & Communication**, 2001](https://www.sciencedirect.com/science/article/abs/pii/S0271530901000052);
- [ERIC record](https://eric.ed.gov/?id=EJ629584)).
- - The same literature records a specific hazard: **"writing to the formulas"** — optimising the score
- rather than the reader — is held to do more harm than good.
-
- That last point is the practical one. A formula that rewards short words would reward *more* codes.
-
- ## 5. Bearing (inference, for the reader, the editor and PM)
+ - Bailin & Grafstein argue the criteria underlying readability formulas **do not constitute a satisfactory
+ basis for assessing reading difficulty**, because style, vocabulary, background knowledge, grammar and
+ coherence interact in ways two length averages cannot capture
+ ([*The linguistic assumptions underlying readability formulae: a critique*, Language & Communication, 2001](https://www.sciencedirect.com/science/article/abs/pii/S0271530901000052);
+ [ERIC EJ629584](https://eric.ed.gov/?id=EJ629584)).
+ - The same literature records the hazard of **"writing to the formulas"** — optimising the score rather
+ than the reader.
- Offered, not urged; none of this is a writing instruction.
+ ## 5. What this page is for now
- 1. **Q52's bespoke metric is measuring the right thing and the standard one is not.** Opaque-token density
- captures undefined vocabulary, which is what both the owner's verdict and §3's mechanism point at.
- **If a standard score is wanted for an owner-facing report, §2 supplies it — but it should not replace
- the opacity measure, and on this evidence it should not be used to settle whether a page reads well.**
- 2. **A readability score would currently reassure rather than inform.** Both owner-facing texts land in an
- ordinary business-prose band. Nothing in that number would have predicted the owner's reaction.
- 3. **Sentence length is the one thing the formulas do see**, and the Campaign owner section runs 24.1
- words per sentence against the Design Document's 18.2. That difference is real and measurable — it is
- simply not the difference the owner named.
+ Narrowly: **if anyone reaches for a Flesch score to decide whether a page reads well, §§3 and 4 are the
+ reasons not to.** That is the whole contribution. It is a fact about the instrument, and it carries no
+ verdict on this project's comprehensibility, which this page has not measured and — per PMR008 — is not
+ assigned to measure. **No new metric study is assigned and none has been run.**
- **Reproduce or refute:** the script and the exact spans are recorded below; re-run them rather than trust
- the table.
-
- ```
- Flesch Reading Ease = 206.835 − 1.015 × (W/S) − 84.6 × (Y/W)
- Flesch–Kincaid Grade = 0.39 × (W/S) + 11.8 × (Y/W) − 15.59
- W = words, S = sentences of ≥3 words, Y = syllables (vowel-group heuristic)
- Spans: Campaign and Design Document — from "## Read this first" to the next "## " heading.
- Equipment — first 6,000 characters of the page source.
- Markdown tables, code fences and link targets removed; link text kept.
- ```
+ PMR008 also records where the useful evidence actually lies, and it is not here: *"the useful acceptance
+ evidence is the reader explaining the actual proposed vision in ordinary language."*
---
## What this page does not claim
- No verdict on anyone's writing, and no instruction to change any page — the reader owns readability
- findings and the editor owns structure. No claim that the Flesch formulas are worthless: they measure
- sentence and word length accurately, which is all they claim to measure. No claim that a particular score
- is a target. The syllable heuristic is approximate and the scores are ±2, so **no ranking in §2 should be
- read as significant below a few points** — which is precisely why §3 rests on the *direction* of the
- comparison and on the mechanism, not on the decimals.
+ **No comprehension verdict on any page of this project**, and no claim about what the owner did or did not
+ find understandable — r1's attempt at that is retracted above. No verdict on anyone's writing; the
+ [reader](/Hold%20The%20Flood/Clarity%20Questions) owns readability findings and the editor owns structure.
+ No claim that the Flesch formulas are worthless: they measure sentence and word length, which is what they
+ claim to measure. No target score. The §2 table is three single measurements of selected spans, is not a
+ survey, and its first two rows should not be ranked against each other.
## Sources
- - [Wikipedia: Flesch–Kincaid readability tests](https://en.wikipedia.org/wiki/Flesch%E2%80%93Kincaid_readability_tests) — both formulas, the interpretation bands, and the stated weaknesses
- - [Bailin, A. & Grafstein, A. (2001), *The linguistic assumptions underlying readability formulae: a critique*, Language & Communication 21(3)](https://www.sciencedirect.com/science/article/abs/pii/S0271530901000052) · [ERIC EJ629584](https://eric.ed.gov/?id=EJ629584)
- - [Clarity Questions Q52](/Hold%20The%20Flood/Clarity%20Questions) — the opaque-token density measurements this page compares against
- - [Brief](/Hold%20The%20Flood/Brief) — the owner's "barely understandable" verdict and PM's current priority
+ - [Wikipedia: Flesch–Kincaid readability tests](https://en.wikipedia.org/wiki/Flesch%E2%80%93Kincaid_readability_tests) — formulas, bands, stated weaknesses
+ - [Bailin & Grafstein (2001), Language & Communication 21(3)](https://www.sciencedirect.com/science/article/abs/pii/S0271530901000052) · [ERIC EJ629584](https://eric.ed.gov/?id=EJ629584)
+ - [PMR008 §4](/Hold%20The%20Flood/Pm%20Reviews/Pmr008) — the correction this revision applies
+ - [Clarity Questions Q52](/Hold%20The%20Flood/Clarity%20Questions) — the opaque-token measurements, which measure whole pages
## Bookkeeping
- **Method.** Formulas quoted from the encyclopedia article; the critique cited to its journal record rather
- than to a summary of it. The three measurements were computed here on live page source fetched
- 2026-09-07, with the spans and transformations stated in §5 so the numbers can be reproduced or refuted.
- Nothing was built, prototyped or tested.
+ **Method (§2).** Markdown stripped of tables, code fences and link targets, link text kept; sentences of
+ three or more words; standard vowel-group syllable heuristic, which is approximate and is why the scores
+ carry roughly ±2. Spans: Campaign and Design Document from `## Read this first` to the next `## ` heading;
+ Equipment, the first 6,000 characters of page source. Nothing was built, prototyped or tested.
- **Stated limits.** The syllable count is the standard vowel-group heuristic, not a dictionary lookup, so
- the scores carry roughly ±2 points. The Design Document row measures its **owner-facing opening**, whereas
- Q52's 0.9 figure measures the **whole page** — different spans, and the two should not be arithmetically
- compared. Three texts is a demonstration that the instrument misranks a case that matters, not a survey.
+ **What r2 changed.** Applied [PMR008 §4](/Hold%20The%20Flood/Pm%20Reviews/Pmr008) in full. Retracted: r1's
+ identification of a wiki passage as the artifact the owner rejected; the claimed demonstrated misranking
+ built on it; and the comparison between two scores 1.8 points apart under a ±2 method. Retained and
+ relabelled: the formulas, the measurements as measurements, the definitional argument in §3, and the
+ literature in §4 as attributed source claims. The measured numbers themselves are unchanged — the error
+ was in what they were said to show, not in the arithmetic.
- **Corrections.** Re-run §5's method and post a different number, and this page changes.
+ **Corrections.** Kill any statement here with a counter-source, or re-run §2's method and post a different
+ number.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9