improve vale rules for 'actors' and 'actor'

Author: honzajavorek

.github/styles/Apify/Capitalization.yml

@@ -3,6 +3,18 @@ message: "The word '%s' should always be capitalized."
 ignorecase: false
 level: error
 tokens:
-  - '(?<!\W)\bactor\b'
-  - '(?<!\W)\bactors\b'
+  # Before the word there should be no: /, -, #, word character
+  # (avoids anchors, URLs, identifiers, and words like 'factors')
+  #
+  # After the word there should be no: /, } (avoids paths or URLs)
+  # Also no . followed by a word character (avoids 'actors.md')
+  - '(?<![\/\-#\w])actors(?![\/\}])(?!\.\w)'
+
+  # Before the word there should be no: /, -, #, ., word character
+  # (avoids anchors, URLs, identifiers, code, and words like 'factors')
+  #
+  # After the word there should be no: /, }, -, word character (avoids paths or URLs)
+  # Also no " =" (avoids code like "actor = ...")
+  # Also no . followed by a word character (avoids 'actor.md' or 'actor.update()')
+  - '(?<![\/\-#\.\w`])actor(?![\/\}\-\w])(?! =)(?!\.\w)'
 nonword: false