Vale CMS Need more than a rule playground? Explore

Style guide explorer

16 open style guides, side by side

What Google, Microsoft, GitLab, Red Hat, GOV.UK, and others tell their writers to do, read out of the rules each one publishes. Browse a guide by topic, or look up a word and see what every guide says about it.

16
guides
598
rules
4,150
distinct terms

What do the guides say about…

Try

Where each guide puts its rules

Each square is a guide’s rules on one topic, darker for more. Read across to see what a guide cares about, and down to see which guides bother with a topic at all.

GuideWord choiceConcisionVoice and toneInclusive languagePunctuationHeadingsNumbers and datesAbbreviationsSource hygieneRules
Google5821125336
Microsoft83551149247
Red Hat8551832537
IBM2131310
GitLab52128311169
Grafana428621134379
Elastic1911351232
Datadog2626
Splunk45211022466
Salesforce2828
Docker10141117
Canonical2111326
Apify751243590
Spectro Cloud2020
18F4131211
GOV.UK314

The guides

Companies

Open-source projects

Government

What most guides agree on

The terms the most guides have a rule about, with the replacement when at least half of them give the same one. Select a term to see each guide’s answer, or browse all 666 terms.

  • 9 guides
  • 8 guides
  • 8 guides
  • 8 guides
  • 7 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 6 guides
  • 5 guides

Where they contradict each other

Cases where one guide’s fix is another guide’s error: the same two wordings, preferred in opposite directions. These are the largest; see every disagreement.

  • are not or aren'tcould not or couldn'tdid not or didn'tdo not or don'tdoes not or doesn't +8 more
    Write “aren't”
    18F, Apify, Google, Grafana, Microsoft
    Write “are not”
    Red Hat
  • that will or that'llwho will or who'llwhat will or what'llwhere will or where'llwhen will or when'll +3 more
    Write “that'll”
    18F
    Write “that will”
    Red Hat
  • it is or it'sthat is or that'sthey are or they'rewe are or we'rewhat is or what's +1 more
    Write “it's”
    18F, Apify, Google, Grafana
    Write “it is”
    Red Hat
  • we will or we'llit will or it'llthey will or they'llwho is or who's
    Write “we'll”
    18F, Apify
    Write “we will”
    Red Hat
  • we have or we'vewhen is or when's
    Write “we've”
    18F, Google, Grafana
    Write “we have”
    Red Hat
  • check box or checkbox
    Write “checkbox”
    Docker, Google, Red Hat
    Write “check box”
    Splunk

How this is built

Each of these organizations publishes its style guide as rules for Vale, an open-source linter for prose. A rule is small and exact: flag this word, suggest that one, at this severity, for this reason. Read together, a guide’s rules are a picture of what the guide asks for, and that is what this explorer draws. Nothing here was summarized by hand.

That also sets its limits. A guide’s advice that nobody wrote a rule for isn’t here, and “terms” counts only rules that name plain words, so a guide written mostly as patterns looks smaller than it is. Each guide’s page names the repository, the commit it was read at, and its license.

“Public configs” is how many of 355 sampled open-source Vale configurations use that guide’s rules. See who uses Vale.