Add local Vale KB style rules (NetwrixKB)

.vale.ini

@@ -5,4 +5,4 @@ MinAlertLevel = suggestion
 BasedOnStyles = Netwrix
 
 [docs/kb/**/*.md]
-BasedOnStyles =
+BasedOnStyles = NetwrixKB

.vale/styles/NetwrixKB/Contractions.yml

@@ -0,0 +1,32 @@
+extends: existence
+message: "Write '%s' out in full for KB articles (e.g., 'do not', 'cannot', 'you will')."
+level: warning
+ignorecase: true
+tokens:
+  - "don't"
+  - "doesn't"
+  - "didn't"
+  - "can't"
+  - "wouldn't"
+  - "shouldn't"
+  - "couldn't"
+  - "isn't"
+  - "aren't"
+  - "wasn't"
+  - "weren't"
+  - "hasn't"
+  - "haven't"
+  - "hadn't"
+  - "you'll"
+  - "it's"
+  - "there's"
+  - "that's"
+  - "won't"
+  - "we're"
+  - "they're"
+  - "you're"
+  - "he's"
+  - "she's"
+  - "we've"
+  - "they've"
+  - "you've"

.vale/styles/NetwrixKB/FirstPersonPlural.yml

@@ -0,0 +1,10 @@
+extends: existence
+message: "Avoid first person plural '%s'. Rewrite without 'we', 'our', 'us', or 'ours'."
+level: warning
+ignorecase: true
+nonword: true
+tokens:
+  - '\bwe\b'
+  - '\bour\b'
+  - '\bours\b'
+  - '\bus\b'

.vale/styles/NetwrixKB/HeadingCase.yml

@@ -0,0 +1,6 @@
+extends: capitalization
+message: "Use title case for KB article headings."
+level: warning
+match: $title
+style: Chicago
+scope: heading

.vale/styles/NetwrixKB/ImpersonalFiller.yml

@@ -0,0 +1,18 @@
+extends: existence
+message: "Remove '%s' and state the point directly."
+level: warning
+ignorecase: true
+nonword: true
+tokens:
+  - '\bit should be noted that\b'
+  - '\bit is important to note that\b'
+  - '\bit is important to ensure that\b'
+  - '\bit is important to\b'
+  - '\bit is recommended that\b'
+  - '\bit is necessary to\b'
+  - '\bit is possible to\b'
+  - '\bit is worth noting that\b'
+  - '\bit must be noted that\b'
+  - '\bas mentioned previously\b'
+  - '\bas previously mentioned\b'
+  - '\bneedless to say\b'

.vale/styles/NetwrixKB/NoteThat.yml

@@ -0,0 +1,7 @@
+extends: existence
+message: "Avoid '%s'. Use a blockquote callout instead: '> **NOTE:** ...' or '> **IMPORTANT:** ...'"
+level: warning
+ignorecase: true
+tokens:
+  - '\bnote that\b'
+  - '\bplease note\b'

.vale/styles/NetwrixKB/Please.yml

@@ -0,0 +1,7 @@
+extends: existence
+message: "Avoid 'please' in instructions. Be direct."
+level: warning
+ignorecase: true
+nonword: true
+tokens:
+  - '\bplease(?!\s+note)\b'

.vale/styles/NetwrixKB/Utilize.yml

@@ -0,0 +1,13 @@
+extends: substitution
+message: "Use '%s' — avoid 'utilize' and its variants."
+level: warning
+ignorecase: true
+swap:
+  '\butilizes\b': 'uses'
+  '\butilized\b': 'used'
+  '\butilizing\b': 'using'
+  '\butilize\b': 'use'
+  '\butilises\b': 'uses'
+  '\butilised\b': 'used'
+  '\butilising\b': 'using'
+  '\butilise\b': 'use'

.vale/styles/NetwrixKB/WeakLinkText.yml

@@ -0,0 +1,10 @@
+extends: existence
+message: "Avoid generic link text '%s'. Write descriptive link text that describes the destination or action."
+level: warning
+ignorecase: true
+tokens:
+  - '\bclick here\b'
+  - '\bthis link\b'
+  - '\blearn more\b'
+  - '\bsee more\b'
+  - '\bread more\b'