All rules

"a" or "an" against the next sound

article-soundon by default (info)English

"a" or "an" that does not fit the next sound, as in "a apple" or "an user"

Example

Flagged
We waited a hour for an user to reply.
What chaff prints
1:11 "a hour" takes "an" before that sound 1:22 "an user" takes "a" before that sound
Fixed
We waited an hour for a user to reply.
What chaff prints
no finding

How to fix

Use "an" before a vowel sound and "a" before a consonant sound.

Why it matters

"A" and "an" follow the sound of the next word, not its spelling ("a user", "an hour", "an MBA"). A slip trips the reader. Words whose spelling and sound disagree, capitals read letter by letter or as a word ("an MBA", "a NASA probe"), and words said both ways ("a SQL", "an SQL") are listed in the lexicon.

What it does not flag

Not before digits ("a 8-hour day"), nor before words the lexicon says are said both ways (SQL, historic). Capitals are read as the lexicon says; unlisted ones are read letter by letter only when short or without a vowel (MBA, NTSB), since longer ones (SALT) may be said as a word. Initials joined by a slash (N/I, N/A) may be read as the words they shorten and are left alone, and an "a" glued to the digit or letter before it ("§ 78a et seq.") is not an article. A document that writes "an" before a sounded h ("an hospital", "an hereditament") at least twice and more often than "a" keeps the older usage as its style, and those are not reported. The fiction and speech presets turn it off.

Turning it off or relaxing it

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

strictreported once there are 1
normalreported once there are 1
relaxedreported once there are 2

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

Genres

Message

"{matched}" takes "{article}" before that sound

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/article-sound.yaml