Vale CMS Need more than a rule playground? Explore

Company

Microsoft Writing Style Guide

47 rules across 8 topics, naming 625 terms.

  • 20 errors
  • 12 warnings
  • 15 suggestions
Read at
6ea641c
License
MIT
Used by
59 of 355 public configs

The guide, by topic

Select a rule to see what it asks for.

Word choice

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

Concision

3 rules · long sentences, filler, and wordy phrases

Voice and tone

5 rules · person, tense, contractions, and claims

Inclusive language

5 rules · gendered, ableist, and loaded terms

Punctuation

11 rules · commas, dashes, quotes, and spacing

Headings

4 rules · capitalization and punctuation in titles

Numbers and dates

9 rules · dates, times, units, and ordinals

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
24/7every day
a ISPan ISP
a myriad ofmyriad
a SQLan SQL
a victim ofAvoid it
able-bodiedAvoid it
abnormallyAvoid it
abortionAvoid it
aboveAvoid it
absentmindedlyAvoid it
accessibleAvoid it
accidentallyAvoid it
actionableAvoid it
adaptoradapter
administrateadminister
adventurouslyAvoid it
adversariesthreat actors
adversarythreat actor
adversely impacthurt
afterwardsafterward
againstAvoid it
alarmAvoid it
alertAvoid it
aliasAvoid it
all acrossacross
all ofall
all of a suddensuddenly
all of thesethese
all rightOK
all-time recordrecord
almost allmost
almost neverseldom
along the lines ofsimilar to
alphabeticalphabetical
alphanumericalalphanumeric
alumnaegraduates
alumnusgraduate
an adequate number ofenough
an appreciable number ofmany
an DLLa DLL
an epilepticAvoid it
an estimatedabout
an URLa URL
and so onAvoid it
and/orAvoid it
anti-aliasingantialiasing
anti-malwareantimalware
anti-spywareantispyware
anti-virusantivirus
anxiouslyAvoid it
any and allall
appendixesappendices
are in agreementagree
are notaren't
arrogantlyAvoid it
artificial intelligenceAI
as a matter of factin fact
as a means ofto
as a means toto
as a result ofbecause of

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