What the style guides say
“it is recommended”
2 of 16 open style guides have a rule about “it is recommended.” 1 of them say to write “you should” instead.
Write this instead
- you should 1 guide
GitLab
Guide by guide
- GitLab Write you should Substitution warning · warning
- Apify Avoid it Bureaucratic voice · suggestion
No rule names it in Google, Microsoft, Red Hat, IBM, Grafana, Elastic, Datadog, Splunk, Salesforce, Docker, Canonical, Spectro Cloud, 18F, GOV.UK. That doesn’t mean those guides approve of it, only that no rule lists it.
Also replaced with “you should”
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.