Vale CMS Need more than a rule playground? Explore

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.

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.

TermWhat each side writes instead
mankind
  • human kind · Google, Grafana
  • humankind · Microsoft
  • humanity, people · GitLab
  • all, everyone, humanity, humankind · Elastic
  • all, everyone, humanity, or humankind · Splunk
hit
  • press · Red Hat
  • select, press, visits · Elastic
  • click · Datadog
  • select · Splunk
a number of
  • several · Red Hat, IBM
  • Specify the number or remove the phrase. · GitLab
  • few · Datadog
abort
  • cancel · Red Hat, IBM
  • stop, cancel, end · Elastic
  • force quit, cancel, fail, close, stop, or end · Splunk
as per
  • per · Microsoft, Elastic
  • according to · Red Hat, IBM
  • Per · Apify
dialogue
  • dialog · Elastic
  • 'speaking(ing)' · 18F
  • discussion · GOV.UK
execute
  • run · Red Hat, Splunk
  • run, start · Elastic
  • 'run' or 'do' · 18F
facilitate
  • help · Docker, Apify
  • ease · Red Hat
  • a more specific word for what you are doing · GOV.UK
kill
  • end · Red Hat
  • cancel, stop · Elastic
  • quit, stop, or end · Splunk
leverage
  • use · Red Hat, IBM, Datadog, Splunk, Apify
  • take advantage of · Microsoft
  • influence or use (unless financial) · GOV.UK
manpower
  • personnel · Google, Grafana, Elastic
  • workforce · Microsoft
  • GitLab team members · GitLab
master
  • primary · Red Hat, Datadog
  • primary, main, controller, active, parent, hub · GitLab
  • manager, primary, or main · Splunk
mouse over
  • hover over · Microsoft, Splunk
  • point to · Red Hat, IBM
  • hover · Salesforce
pop-up window
  • dialog box · Microsoft
  • window · Red Hat
  • dialog · GitLab
sanity check
  • review · Elastic, Splunk
  • quick check · Microsoft
  • test · IBM
slave
  • secondary · Red Hat, Datadog
  • secondary, agent, standby, child, spoke · GitLab
  • peer or replica · Splunk
terminate
  • stop · Google, Grafana
  • end · Red Hat, IBM
  • stop, exit · Elastic
via
  • through · Red Hat, IBM
  • with', 'through', or 'by using · GitLab
  • with · Datadog
24/7
  • every day · Microsoft
  • 24x7 · Red Hat
a api
  • an API · Elastic, Apify
  • an API- · Apify
abnormal
  • atypical, not typical · Elastic
  • atypical or not typical · Splunk
above
  • preceding · Google
  • earlier · Red Hat
ad-hoc
  • if needed · Elastic, Splunk
  • ad hoc · Red Hat
as well as
  • and · Red Hat
  • And · Apify
at this point in time
  • at this point · Microsoft
  • now, then · Elastic
blacklist
  • blocklist · Red Hat, Grafana, Elastic
  • deny list, reject, deny, or exclude · Splunk
bottom left
  • lower left · Red Hat
  • bottom-left · Apify
bottom right
  • lower right · Red Hat
  • bottom-right · Apify
can not
  • can't · Splunk, Apify
  • cannot · Red Hat
case insensitive
  • not case-sensitive · Red Hat, IBM
  • case-insensitive · GitLab
check-out
  • checkout · Red Hat
  • see · Splunk
cloud
  • Google Cloud Platform · Google
  • Cloud · Canonical
collaborate
  • work together · Red Hat
  • work with · GOV.UK
commence
  • begin · Red Hat
  • start · Apify
demilitarized zone
  • DMZ · Red Hat, IBM
  • perimeter network · Microsoft
disable
  • deactivate, deselect, hide, turn off · Elastic
  • deactivate, deselect, hide, inactive, turn off · Splunk
eg
  • for example · Red Hat
  • e.g., · 18F
ergo
  • therefore · Microsoft, Docker
  • 'therefore' or 'hence' · Canonical
etc
  • and so on · Red Hat, IBM, Elastic
  • etc. · Apify
flesh-colored
  • dark brown, cream, beige · Elastic
  • dark brown, cream, or beige · Splunk
google cloud platform
  • Google Cloud · Datadog
  • Google Cloud Platform · Canonical
grayed-out
  • unavailable · Google, Grafana
  • not displayed · Red Hat
hangs
  • stops responding · Microsoft
  • stops responding or freezes · Splunk
ie
  • that is · Red Hat
  • i.e., · 18F
in addition
  • also · Microsoft, Elastic, Apify
  • Also · Apify
in order to
  • to · Google, Microsoft, Red Hat, IBM, Grafana, Elastic, Datadog, Docker
  • Remove 'in order' and leave 'to'. · GitLab
in spite of
  • despite · Microsoft, Elastic
  • regardless of · Red Hat, IBM
in the event that
  • if · Microsoft, Elastic
  • If · Apify
initiate
  • start · Red Hat
  • start or begin · GOV.UK
ipod
  • iPod · Apify
  • MP3 player · 18F
keep in mind
  • remember · Red Hat, IBM
  • consider · Datadog
key
  • type · IBM
  • important or significant (or remove altogether) · GOV.UK
launch
  • start · Red Hat, IBM
  • open · Elastic, Splunk
long press
  • select and hold · Elastic, Splunk
  • touch & hold · Google
machine-learning
  • machine learning · GitLab
  • ML · Datadog
may
  • might · Red Hat, Splunk
  • can, might · Elastic
modal
  • dialog · GitLab
  • dialog box · Grafana
n/a
  • not applicable · GitLab
  • n/a · Splunk
navbar
  • navigation menu · Elastic
  • left main menu · Spectro Cloud
not in a position to
  • unable · Microsoft
  • cannot · Elastic
note that
  • Remove the phrase 'note that'. · GitLab
  • **Note**: · Datadog
npm
  • CNM · Datadog
  • npm · Apify
off-premise
  • off-premises · Microsoft
  • on-premises · IBM
on the fly
  • dynamically · Red Hat, IBM
  • real-time · Datadog
on-premise
  • on-premises · Microsoft, IBM, Splunk
  • on-site · Red Hat
open telemetry
  • OpenTelemetry (OTel) · Red Hat
  • OpenTelemetry · GitLab
open-source
  • open source · Google, Grafana
  • 'open source' · 18F
out-of-the-box
  • by default · Apify
  • default · Apify
pain point
  • challenge · Red Hat, IBM
  • problem · Apify
pathname
  • path · Microsoft, Splunk
  • path name · Red Hat
percent
  • % · Datadog
  • \% · Splunk
power down
  • turn off · Red Hat
  • turn on · IBM
preloaded
  • preinstalled · Red Hat
  • preinstall · IBM
prior to
  • before · Red Hat, IBM, Apify
  • Before · Apify
run-time
  • run time · Red Hat
  • runtime · Splunk
simple
  • efficient, basic · Elastic
  • 'straightforward', 'uncomplicated', or 'clear' · 18F
skin-toned
  • dark brown, cream, beige · Elastic
  • dark brown, cream, or beige · Splunk
some of the
  • some · Microsoft, Elastic
  • Some · Apify
spec
  • specification · Microsoft
  • spec · Red Hat
state-of-the-art
  • latest · Red Hat
  • modern · Apify
switch off
  • turn off · Red Hat
  • power on · IBM
switch on
  • turn on · Red Hat
  • power on · IBM
synch
  • sync · Google, Red Hat, Grafana
  • sync or synchronize · Splunk
tar file
  • .tar file · Red Hat
  • TAR file · Spectro Cloud
tarball
  • tar file · IBM, Splunk
  • .tar file · Red Hat
timeseries
  • time series · Grafana
  • time series or time-series · Splunk
tooling
  • tool · Red Hat
  • tools · IBM
unzip
  • extract · Red Hat, Grafana
  • unzip · IBM
urn
  • URN · Red Hat
  • URI · Splunk
utilise
  • utilize · Elastic, Apify
  • use · GOV.UK
utilized
  • used · Docker, Apify
  • Used · Apify
utilizes
  • uses · Docker, Apify
  • Uses · Apify
utilizing
  • using · Red Hat, Docker, Apify
  • Using · Apify
visit
  • see · Datadog
  • go to · Splunk
whitelist
  • allowlist · Red Hat, Grafana, Elastic
  • allow list, allow, accept, or include · Splunk
wish
  • want · Red Hat, IBM, Splunk, Docker
  • need · Grafana
with regard to
  • regarding · Microsoft, Elastic
  • about · Apify
with the exception of
  • except for · Microsoft, Elastic
  • except · Apify
zip file
  • .zip file · Red Hat
  • ZIP file · Spectro Cloud

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.