Company
Microsoft Writing Style Guide
47 rules across 8 topics, naming 625 terms.
- 20 errors
- 12 warnings
- 15 suggestions
- The guide
- learn.microsoft.com
- Rules from
- vale-cli/Microsoft
- 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 avoidAuto Avoid 9 General URL Jargon 3 Terms 91 UI verbs 2 URL format Vocab 21
Concision
3 rules · long sentences, filler, and wordy phrasesAdverbs 264 Sentence length Wordiness 119
Voice and tone
5 rules · person, tense, contractions, and claimsContractions 30 First person 8 Passive 177 Uppercase We 5
Inclusive language
5 rules · gendered, ableist, and loaded termsAccessibility 24 Bias free 5 Gender 2 Gender bias 37 Militaristic 13
Punctuation
11 rules · commas, dashes, quotes, and spacingDashes Ellipses Exclamation points Hyphens Oxford comma 2 Plurals Question marks Quotes Semicolon Spacing 3 Suspended
Headings
4 rules · capitalization and punctuation in titlesHeading acronyms Heading colons Heading punctuation Headings
Numbers and dates
9 rules · dates, times, units, and ordinalsAMPM 3 Date format Date numbers 32 Date order Negative Ordinal 3 Percentages Range time Units 10
Abbreviations
2 rules · acronyms, latin, and periodsAcronyms Foreign 4
The word list
Every term this guide’s rules name, and what it says to write instead.
| Instead of | Write | Rule |
|---|---|---|
| 24/7 | every day | |
| a ISP | an ISP | |
| a myriad of | myriad | |
| a SQL | an SQL | |
| a victim of | Avoid it | |
| able-bodied | Avoid it | |
| abnormally | Avoid it | |
| abortion | Avoid it | |
| above | Avoid it | |
| absentmindedly | Avoid it | |
| accessible | Avoid it | |
| accidentally | Avoid it | |
| actionable | Avoid it | |
| adaptor | adapter | |
| administrate | administer | |
| adventurously | Avoid it | |
| adversaries | threat actors | |
| adversary | threat actor | |
| adversely impact | hurt | |
| afterwards | afterward | |
| against | Avoid it | |
| alarm | Avoid it | |
| alert | Avoid it | |
| alias | Avoid it | |
| all across | across | |
| all of | all | |
| all of a sudden | suddenly | |
| all of these | these | |
| all right | OK | |
| all-time record | record | |
| almost all | most | |
| almost never | seldom | |
| along the lines of | similar to | |
| alphabetic | alphabetical | |
| alphanumerical | alphanumeric | |
| alumnae | graduates | |
| alumnus | graduate | |
| an adequate number of | enough | |
| an appreciable number of | many | |
| an DLL | a DLL | |
| an epileptic | Avoid it | |
| an estimated | about | |
| an URL | a URL | |
| and so on | Avoid it | |
| and/or | Avoid it | |
| anti-aliasing | antialiasing | |
| anti-malware | antimalware | |
| anti-spyware | antispyware | |
| anti-virus | antivirus | |
| anxiously | Avoid it | |
| any and all | all | |
| appendixes | appendices | |
| are in agreement | agree | |
| are not | aren't | |
| arrogantly | Avoid it | |
| artificial intelligence | AI | |
| as a matter of fact | in fact | |
| as a means of | to | |
| as a means to | to | |
| as a result of | because 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