All rules

Words that do not agree

agreement-slipon by defaultEnglish

Words that no longer agree after an edit, as in "these new version"

Example

Flagged
These new version will ship in May.
What chaff prints
1:1 "These new version" mixes singular and plural
Fixed
This new version will ship in May.
What chaff prints
no finding

How to fix

Make the determiner and the noun agree ("a significant change" or "significant changes"). For a possessive, write the subject you meant ("Your can" becomes "You can", "their is" becomes "there is"). For two determiners in a row, drop one ("the some roads" becomes "some roads", or "that some roads" if that was meant).

Why it matters

A determiner and a noun that differ in number ("a significant changes", "these new version"), a possessive where the subject belongs ("Your can check"), or two determiners in a row ("the some roads"), is left over from an edit that fixed one word and not the other. The reader stumbles, and the document looks rushed. Only forms with one reading are counted; nouns spelled alike in both numbers ("series", "data"), a word right after "this" or "these" (which can stand alone), and nouns that modify another noun ("a sales team") are not.

What it does not flag

Nouns spelled alike in both numbers ("series", "data"), a word right after "this" or "these", nouns that modify another noun ("a sales team"), and a possessive after a preposition with "will" or "can" as its noun ("at its will") are not reported.

Turning it off or relaxing it

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

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
Turned off by the genre in
literature/fiction, literature/essay, literature/poetry, literature/play, speech/transcript

Genres

Message

"{word}" mixes singular and plural

"{word}" mixes singular and plural

"{word}" puts a possessive where the subject belongs

"{word}" puts two determiners in a row

This page is built from the rule's definition file:packages/chaff/rules/agreement-slip.yaml