Vale CMS Need more than a rule playground? Explore

Government

18F content guide

11 rules across 5 topics, naming 82 terms.

  • 4 errors
  • 7 warnings
  • 0 suggestions
Rules from
testthedocs/18F
Read at
274d3b5
License
MIT

The guide, by topic

Select a rule to see what it asks for.

Word choice

4 rules · preferred terms, jargon, and words to avoid

Voice and tone

1 rule · person, tense, contractions, and claims

Punctuation

3 rules · commas, dashes, quotes, and spacing

Headings

1 rule · capitalization and punctuation in titles

Abbreviations

2 rules · acronyms, latin, and periods

The word list

Every term this guide’s rules name, and what it says to write instead.

Instead ofWrite
advancingAvoid using 'advancing.'
agendaAvoid using 'agenda' (unless you’re talking about a meeting).
are notaren't
back-end'back end'
Band-Aidbandage
Bubble Wrappackaging bubbles
cannotcan't
Chapsticklip balm
citizen'people' or 'The public'
combating'working against' or 'fighting'
commitBe more specific — we’re either doing something or we’re not.
could notcouldn't
countering'answering' or 'responding'
Crayolacrayons
D.C.DC
deployAvoid using 'deploy' (unless you’re talking about the military or software).
dialogue'speaking(ing)'
did notdidn't
disincentivizeAvoid using 'disincentivize.'
do notdon't
does notdoesn't
dropdown'drop-down' or 'drop down'
Dumpsterwaste container, trash container
ege.g.,
empowerAvoid using 'empower.'
execute'run' or 'do'
focusingAvoid using 'focusing.'
fosterAvoid using 'foster' (unless it’s children).
has nothasn't
have nothaven't
Hi-Literhighlighting marker
how ishow's
how willhow'll
iei.e.,
illegal aliens'undocumented immigrants'
incentivizeAvoid using 'incentivize.'
innovativeUse words that describe the positive outcome of the innovation.
iPodMP3 player
is notisn't
it isit's
it willit'll
keyAvoid using 'key' (unless it unlocks something).
Kleenextissue
leverageAvoid using 'leverage' (unless you're using it in the financial sense).
open-source'open source'
Plexiglasplastic glass
Post-it noteadhesive note
progressWhat are you actually doing?
promoteAvoid using 'promote' (unless you’re talking about an ad campaign).
Q-Tipscotton swabs
Scotch tapetransparent tape
should notshouldn't
simple'straightforward', 'uncomplicated', or 'clear'
streamlineAvoid using 'streamline.'
strengtheningAvoid using 'strengthening' (unless you’re referring to bridges or other structures).
Styrofoamplastic foam
tacklingAvoid using 'tackling' (unless you’re referring to football or another contact sport).
Taserstun gun
that isthat's
that willthat'll

These rules run in Vale, which checks a whole documentation set against a guide in your editor and on every pull request.

All 16 guides