Vale CMS Need more than a rule playground? Explore

What the style guides say

“that is”

6 of 16 open style guides have a rule about “that is.” 5 of them say to write “that's” instead.

Write this instead

  • that's 5 guides

    Google, Microsoft, Grafana, Apify, 18F

Guide by guide

  • Google Write that's Contractions · suggestion
  • Microsoft Write that's Contractions · error
  • GitLab Avoid it Unclear antecedent · warning
  • Grafana Write that's Google contractions · suggestion
  • Apify Write that's Contractions · suggestion
  • 18F Write that's Contractions · error

No rule names it in Red Hat, IBM, Elastic, Datadog, Splunk, Salesforce, Docker, Canonical, Spectro Cloud, GOV.UK. That doesn’t mean those guides approve of it, only that no rule lists it.

Guides that ask for it

One guide’s fix can be another guide’s error. These rules tell writers to use “that is”.

  • Google says to write it instead of i.e.
  • Microsoft says to write it instead of that's
  • Red Hat says to write it instead of that's
  • IBM says to write it instead of i.e.
  • Datadog says to write it instead of i.e.
  • Splunk says to write it instead of i.e.
  • Docker says to write it instead of i.e.

Catch it in every draft

Each line above is a rule one of these organizations publishes for Vale, an open-source linter for prose. Install a guide’s rules and Vale flags the term wherever it appears, in your editor and on every pull request.