All rules

Too many contrast frames

contrast-framingon by default (info)Japanese / English

Contrasts piled up ("It's not X, it's Y"), knocking down an X nobody said

Example

Flagged
This tool is not just software, but a culture. It's not a feature. It's a promise.
What chaff prints
1:1 "not just" and other contrast frames: 8.2 per 1000 words (limit 3) 1:48 "it's not" and other contrast frames: 8.2 per 1000 words (limit 3)
Fixed
This tool cut the time to draft a quote by ten minutes.
What chaff prints
no finding

The rule measures the whole document, so this example was tried with an ordinary passage (about 200 words) after it that gives chaff nothing to report.

How to fix

Drop the X you knocked down and say Y directly.

Why it matters

"It's not X, it's Y" and "not just X, but Y" sort out a point when used once. Piled up, the text keeps knocking down an X nobody said, a habit well known in generated text.

What it does not flag

A single contrast, a denial nobody answers, and two denials in a row ("It's not ready. It's not tested.") are not reported. Short documents are not measured.

Turning it off or relaxing it

Silence this one spot (in the document)
<!-- stet: contrast-framing — reason -->
Relax it for the team (the reason is kept as a comment in chaff.yaml)
npx chaffjs relax contrast-framing --why "reason"
Turn it off for the team (chaff.yaml)
rules: contrast-framing: off
Technical details
Layer
L2
Status
stable
Severity
info
Languages
Japanese and English
Suited to
technical/readme, blog, business, 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).

strictup to 2 contrast frames per 1000 words
normalup to 3 contrast frames per 1000 words
relaxedup to 6 contrast frames per 1000 words

By genre

Runs by default in
technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, academic/paper
Turned off by the genre in
legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript
Not suited to, and not run in
technical/spec

Genres

Message

"{matched}" and other contrast frames: {density} per 1000 words (limit {limit})

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/contrast-framing.yaml