All rules

A forecast revision that moves the other way

revision-direction-mismatchon by defaultJapanese / English

A forecast said to be revised up whose new figure is lower, or the reverse

Example

Flagged
We are revising upward the full-year forecast. | Item | Previous forecast | Revised forecast | | --- | --- | --- | | Net sales | 5,200 | 5,000 |
What chaff prints
5:23 "revising upward" is written, but Net sales goes the other way, from 5,200 to 5,000
Fixed
We are revising downward the full-year forecast. | Item | Previous forecast | Revised forecast | | --- | --- | --- | | Net sales | 5,200 | 5,000 |
What chaff prints
no finding

How to fix

Check whether the word of revision or the previous and revised figures are right, and correct the other. If the items move different ways, say so item by item ("we lower net sales and raise operating profit").

Why it matters

When a release says the forecast is "revised upward" and the table below it shows a revised figure lower than the previous one, readers cannot tell whether to believe the sentence or the table. It happens when last year's release is copied and only the figures are replaced, or when the columns are swapped. A table with a column of the previous forecast (Previous forecast) and one of the revised forecast (Revised forecast), or a row of each, is compared with the word of revision in the same section, from a heading to the next (revised upward, revised downward; raised, lowered and cut only with forecast, guidance or outlook in their sentence). When the sentence of the word names items (net sales, operating profit; "Operating profit (loss)" is named without its brackets too) those items are checked; when it names none, the first item of the table is.

What it does not flag

A section with words of both directions, a section with no word of revision, and a table without exactly one previous and one revised column (or row) are not compared. Named items that moved both ways (the word cannot be tied to one of them), a cell that is not a number ("-", "TBD"), cells written in different units and an unchanged figure are not reported. A sentence that names no item is checked against the first item of the table only; later items that move the other way are not reported.

Turning it off or relaxing it

Silence this one spot (in the document)
<!-- stet: revision-direction-mismatch — reason -->
Relax it for the team (the reason is kept as a comment in chaff.yaml)
npx chaffjs relax revision-direction-mismatch --why "reason"
Turn it off for the team (chaff.yaml)
rules: revision-direction-mismatch: off
Technical details
Layer
L3
Status
stable
Severity
warning
Languages
Japanese and English
Suited to
business, technical, blog, legal, docs, academic, literature, speech

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).

stricterror
normalwarning
relaxedinfo

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

Genres

Message

"{word}" is written, but {item} goes the other way, from {previous} to {revised}

This page is built from the rule's definition file:packages/chaff/rules/revision-direction-mismatch.yaml