docs: bring back vale rules

rework Capitalization rules
turn it back on

Author: TC-MO

.github/styles/Apify/Capitalization.yml

@@ -1,7 +1,9 @@
-extends: existence
-message: "The word '%s' should always be capitalized."
+extends: substitution
+message: "Use '%s' instead of '%s'."
 ignorecase: false
 level: error
-tokens:
-  - '\bactor\b'
-  - '\bactors\b'
+scope: text & ~alt
+nonword: true
+swap:
+  '\bactor\b': Actor
+  '\bactors\b': Actors

.vale.ini

@@ -31,7 +31,6 @@ Microsoft.URLFormat = NO
 Microsoft.GeneralURL = NO
 Microsoft.RangeFormat = NO
 Apify.Apify = NO
-Apify.Capitalization = NO
 Apify.Languages = NO
 
 [{README.md,CONTRIBUTING.md}]