Where the style guides disagree
A style guide is a set of choices, and 16 guides do not all make the same ones. These are the places their published rules pull apart: 49 word pairs preferred in opposite directions, and 99 terms that different guides replace with different words.
None of this makes a guide wrong. It is the case for picking one and holding to it.
Opposite advice
One guide’s fix is another guide’s error: the same two wordings, each flagged by one side and asked for by the other. Grouped by which guides are on each side.
- Write “aren't”
- 18F, Apify, Google, Grafana, Microsoft
- Write “are not”
- Red Hat
- Write “that'll”
- 18F
- Write “that will”
- Red Hat
- that will or that'll
- who will or who'll
- what will or what'll
- where will or where'll
- when will or when'll
- why is or why's
- why will or why'll
- how will or how'll
- Write “it's”
- 18F, Apify, Google, Grafana
- Write “it is”
- Red Hat
- Write “we'll”
- 18F, Apify
- Write “we will”
- Red Hat
- Write “we've”
- 18F, Google, Grafana
- Write “we have”
- Red Hat
- Write “checkbox”
- Docker, Google, Red Hat
- Write “check box”
- Splunk
- Write “filename”
- Docker, GitLab, Google, Grafana
- Write “file name”
- Splunk
- Write “cannot”
- Red Hat
- Write “can't”
- 18F, Apify, Google, Grafana, Microsoft
- Write “ebook”
- Apify, Red Hat
- Write “e-book”
- Microsoft
- Write “multicloud”
- Red Hat
- Write “multi-cloud”
- Datadog
- multi-cloud or multicloud
- Write “appendixes”
- Red Hat
- Write “appendices”
- Docker, Microsoft
- Write “dismount”
- Red Hat
- Write “demount”
- IBM
- demount or dismount
- Write “matrixes”
- Red Hat
- Write “matrices”
- Microsoft
- matrices or matrixes
- Write “hostname”
- Red Hat
- Write “host name”
- Splunk
- host name or hostname
- Write “sign in”
- GitLab
- Write “log in”
- Splunk
- Write “lifecycle”
- GitLab
- Write “life cycle”
- Datadog
- life cycle or lifecycle
- Write “dialog box”
- Grafana
- Write “dialog”
- GitLab
- dialog or dialog box
- Write “stylesheet”
- Grafana
- Write “style sheet”
- style sheet or stylesheet
- Write “dataset”
- Splunk
- Write “data set”
- Red Hat
- data set or dataset
- Write “datasheet”
- Salesforce
- Write “data sheet”
- Red Hat
- data sheet or datasheet
- Write “google cloud platform”
- Canonical
- Write “google cloud”
- Datadog
Same term, different fix
The guides agree the term is a problem and part ways on what to write instead. Select a term for each guide’s rule.
| Term | What each side writes instead |
|---|---|
| mankind |
|
| hit |
|
| a number of |
|
| abort |
|
| as per |
|
| dialogue |
|
| execute |
|
| facilitate |
|
| kill |
|
| leverage |
|
| manpower |
|
| master |
|
| mouse over |
|
| pop-up window |
|
| sanity check |
|
| slave |
|
| terminate |
|
| via |
|
| 24/7 |
|
| a api |
|
| abnormal |
|
| above |
|
| ad-hoc |
|
| as well as |
|
| at this point in time |
|
| blacklist |
|
| bottom left |
|
| bottom right |
|
| can not |
|
| case insensitive |
|
| check-out |
|
| cloud |
|
| collaborate |
|
| commence |
|
| demilitarized zone |
|
| disable |
|
| eg |
|
| ergo |
|
| etc |
|
| flesh-colored |
|
| google cloud platform |
|
| grayed-out |
|
| hangs |
|
| ie |
|
| in addition |
|
| in order to |
|
| in spite of |
|
| in the event that |
|
| initiate |
|
| ipod |
|
| keep in mind |
|
| key |
|
| launch |
|
| long press |
|
| machine-learning |
|
| may |
|
| modal |
|
| n/a |
|
| navbar |
|
| not in a position to |
|
| note that |
|
| npm |
|
| off-premise |
|
| on the fly |
|
| on-premise |
|
| open telemetry |
|
| open-source |
|
| out-of-the-box |
|
| pain point |
|
| pathname |
|
| percent |
|
| power down |
|
| preloaded |
|
| prior to |
|
| run-time |
|
| simple |
|
| skin-toned |
|
| some of the |
|
| spec |
|
| state-of-the-art |
|
| switch off |
|
| switch on |
|
| synch |
|
| tar file |
|
| tarball |
|
| timeseries |
|
| tooling |
|
| unzip |
|
| urn |
|
| utilise |
|
| utilized |
|
| utilizes |
|
| utilizing |
|
| visit |
|
| whitelist |
|
| wish |
|
| with regard to |
|
| with the exception of |
|
| zip file |
|
How this is read
Each organization here publishes its guide as rules for Vale, an open-source linter for prose. A disagreement on this page is two of those rules that can’t both be followed. Advice a guide gives in prose, with no rule behind it, isn’t counted. Browse every term or go back to the explorer.