A summary value that differs from the body
summary-fact-mismatchon by defaultJapanese / English
A value in the summary (a deadline, a fee) that differs from the body
Example
How to fix
Check which is right, the summary or the body, and correct the other.
Why it matters
The opening and the summary are read by people who never read the body. A value there that differs from the body sends them away with the wrong one. It happens when the body is corrected and the summary is not. Values written as "Item: value" or "The item is value" before the first heading, or in a section headed Summary, Abstract or Overview, are compared with the body's values for the same item, and so is a count with no label, by the verb and the words of what it counts ("We gained 52 new customers"). A summary's "lowered the error rate from 2.4% to 1.6%" is paired with the two values the body gives the same item under two conditions (before and after, without and with, 2025 and 2026). The date of an event in the opening ("will release it on November 9, 2026") is compared with a body sentence that has a word for the same event (release, launch, held) and one date. It is pointed out only when the body gives one value throughout and the summary gives another.
What it does not flag
When the body gives the item more than one value (per session, per group), which one the summary should match is not settled, so nothing is said. Values in different units and values with a condition ("from $300") are not compared. A "from X to Y" is compared only when a body sentence names the same item and the condition of each of its two values can be read; a range ("ranging from 10 to 20") is not a change and is left alone. An event's date is compared only when both dates give the year, month and day; a sentence with two dates (a period) or with the words of another event (the day it was announced and the day of the release) is not read, nor is a body sentence that names something the opening sentence does not (another product).
Turning it off or relaxing it
Technical details
- Layer
- L3
- Status
- stable
- Severity
- warning
- Languages
- Japanese and English
- Suited to
- business, technical, blog, legal, docs, academic, literature, speech
- Reads from the document
- quantities
Levels
Set a level for this rule under rules in chaff.yaml. With nothing set, it runs at the level its genre gives it (see By genre below).
| normal | warning |
|---|---|
| relaxed | info |
This rule has no limit to count to. A level sets how a finding is marked: relaxed keeps the finding and marks it a step lower.
By genre
- Runs by default in
- technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, speech/address, speech/transcript
- Turned off by the genre in
- literature/fiction, literature/essay, literature/poetry, literature/play
Message
The summary gives "{label}" as {value}, but the body gives {other}
Rewrite depth (chaff fix-plan --depth): light — words and sentences; the structure and the voice stay
This page is built from the rule's definition file:packages/chaff/rules/summary-fact-mismatch.yaml