What the style guides say
“we are”
5 of 16 open style guides have a rule about “we are.” All 5 say to write “we're” instead.
Write this instead
- we're 5 guides
Google, Microsoft, Grafana, Apify, 18F
Guide by guide
- Google Write we're Contractions · suggestion
- Microsoft Write we're Contractions · error
- Grafana Write we're Google contractions · suggestion
- Apify Write we're Contractions · suggestion
- 18F Write we're Contractions · error
No rule names it in Red Hat, IBM, GitLab, 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 “we are”.
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.