Vale CMS Need more than a rule playground? Explore

What the style guides say

“note that”

3 of 16 open style guides have a rule about “note that.” They don’t agree on what to write instead: 1 say “Remove the phrase 'note that'.,” and the rest give a different answer.

What to write instead, by guide

  • Remove the phrase 'note that'. 1 guide

    GitLab

  • **Note**: 1 guide

    Datadog

Guide by guide

  • GitLab Write Remove the phrase 'note that'. Wordy · suggestion
  • Datadog Write **Note**: words_case_insensitive · warning
  • Splunk Avoid it Dont use · warning

No rule names it in Google, Microsoft, Red Hat, IBM, Grafana, Elastic, Salesforce, Docker, Canonical, Apify, Spectro Cloud, 18F, GOV.UK. That doesn’t mean those guides approve of it, only that no rule lists it.

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.