Vale CMS Need more than a rule playground? Explore

Company

Apify writing style guide

90 rules across 6 topics, naming 1,114 terms.

  • 4 errors
  • 19 warnings
  • 67 suggestions
Read at
1cae9f7
License
Apache-2.0
Used by
1 of 355 public configs

The guide, by topic

Select a rule to see what it asks for.

Word choice

75 rules · preferred terms, jargon, and words to avoid

Concision

1 rule · long sentences, filler, and wordy phrases

Voice and tone

2 rules · person, tense, contractions, and claims

Punctuation

4 rules · commas, dashes, quotes, and spacing

Headings

3 rules · capitalization and punctuation in titles

Abbreviations

5 rules · acronyms, latin, and periods

The word list

Every term this guide’s rules name, and what it says to write instead.

Instead ofWrite
1 additional1 more
1 extra1 more
1-on-11on1
1t11on1
a Actoran Actor
a APIan API
a API-an API-
a Apifyan Apify
a bit complexcomplex
a bit confusingconfusing
a bit differentdifferent
a bit fastfast
a bit lessless
a bit misleadingmisleading
a bit moremore
a bit slowslow
a bit trickytricky
a ETLan ETL
a FAQan FAQ
a FSAan FSA
a heiran heir
a herban herb
a honestan honest
a honoran honor
a houran hour
a HTMLan HTML
a HTTPan HTTP
a ICUan ICU
a IDan ID
a large number ofmany
a MCPan MCP
a momenta few seconds
a MVPan MVP
a NLPan NLP
a npman npm
a OAuthan OAuth
a OOMan OOM
A piece of cakestraightforward
a reminder ofAvoid it
a RSSan RSS
a SDKan SDK
a SPAan SPA
a SSHan SSH
a SSLan SSL
a XMLan XML
absolutely freefree
accommodate your needswork for you
accordinglyAvoid it
act accordinglyAvoid it
actor.json fileactor.json
Add a newAvoid it
Additional More
additionallyAvoid it
addonadd-on
addonsadd-ons
aforementionedthese
AI AgentsAI agents
AI toolstools for AI
AI-first platformplatform built for AI
AI-native platformplatform built for AI

These rules run in Vale, which checks a whole documentation set against a guide in your editor and on every pull request.

All 16 guides