From 8d8b85c80cf00fcd3e3ff97883fa8c0aeb3edbda Mon Sep 17 00:00:00 2001 From: james-haytko_nwx Date: Mon, 2 Mar 2026 17:01:54 -0600 Subject: [PATCH] Fix Vale rule messages and remove overly broad tokens - Fix %s position in substitution rule messages so they show matched text correctly - Remove 'for additional information' from BoilerplateCrossRef - Remove 'just' from CondescendingWords to avoid false positives Generated with AI Co-Authored-By: Claude Code --- .vale/styles/Netwrix/BoilerplateCrossRef.yml | 1 - .vale/styles/Netwrix/Checkbox.yml | 2 +- .vale/styles/Netwrix/CondescendingWords.yml | 1 - .vale/styles/Netwrix/Dropdown.yml | 2 +- .vale/styles/Netwrix/InOrderTo.yml | 2 +- .vale/styles/Netwrix/IsAbleTo.yml | 2 +- .vale/styles/Netwrix/LoginVerb.yml | 2 +- .vale/styles/Netwrix/MakeSure.yml | 2 +- .vale/styles/Netwrix/ProvidesAbilityTo.yml | 2 +- .vale/styles/Netwrix/Utilize.yml | 2 +- .vale/styles/Netwrix/WishTo.yml | 2 +- .vale/styles/Netwrix/WordyPhrases.yml | 2 +- 12 files changed, 10 insertions(+), 12 deletions(-) diff --git a/.vale/styles/Netwrix/BoilerplateCrossRef.yml b/.vale/styles/Netwrix/BoilerplateCrossRef.yml index 3c0416696a..c43d66276e 100644 --- a/.vale/styles/Netwrix/BoilerplateCrossRef.yml +++ b/.vale/styles/Netwrix/BoilerplateCrossRef.yml @@ -3,5 +3,4 @@ message: "Avoid '%s'. Write specific cross-reference text that describes what th level: suggestion ignorecase: true tokens: - - '\bfor additional information\b' - '\bfor more information\b' diff --git a/.vale/styles/Netwrix/Checkbox.yml b/.vale/styles/Netwrix/Checkbox.yml index cfdad29c60..b21419e737 100644 --- a/.vale/styles/Netwrix/Checkbox.yml +++ b/.vale/styles/Netwrix/Checkbox.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'checkbox' (one word) instead of '%s'." +message: "Use '%s' instead of 'check box'." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/CondescendingWords.yml b/.vale/styles/Netwrix/CondescendingWords.yml index cfd728407d..714ce7b3c8 100644 --- a/.vale/styles/Netwrix/CondescendingWords.yml +++ b/.vale/styles/Netwrix/CondescendingWords.yml @@ -6,6 +6,5 @@ nonword: true tokens: - '\bsimply\b' - '\beasily\b' - - '\bjust\b' - '\bbasically\b' - '\bobviously\b' diff --git a/.vale/styles/Netwrix/Dropdown.yml b/.vale/styles/Netwrix/Dropdown.yml index 0151b8f313..0e3a9a6c8e 100644 --- a/.vale/styles/Netwrix/Dropdown.yml +++ b/.vale/styles/Netwrix/Dropdown.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'drop-down' (hyphenated) instead of '%s'." +message: "Use 'drop-down' (hyphenated). Avoid 'dropdown' and 'drop down'." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/InOrderTo.yml b/.vale/styles/Netwrix/InOrderTo.yml index a026ffd49f..b461f5377c 100644 --- a/.vale/styles/Netwrix/InOrderTo.yml +++ b/.vale/styles/Netwrix/InOrderTo.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'to' instead of '%s'." +message: "Use '%s' instead of 'in order to'." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/IsAbleTo.yml b/.vale/styles/Netwrix/IsAbleTo.yml index 611176cfa7..19104e6f54 100644 --- a/.vale/styles/Netwrix/IsAbleTo.yml +++ b/.vale/styles/Netwrix/IsAbleTo.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'can' instead of '%s'." +message: "Use '%s' instead of the 'able to' construction." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/LoginVerb.yml b/.vale/styles/Netwrix/LoginVerb.yml index 38ae43ecfa..e3d6890607 100644 --- a/.vale/styles/Netwrix/LoginVerb.yml +++ b/.vale/styles/Netwrix/LoginVerb.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'log in' (two words) as a verb instead of '%s'." +message: "Use '%s' — 'login' as a verb should be two words." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/MakeSure.yml b/.vale/styles/Netwrix/MakeSure.yml index 2aec6aeb9f..dda8e66783 100644 --- a/.vale/styles/Netwrix/MakeSure.yml +++ b/.vale/styles/Netwrix/MakeSure.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'ensure' instead of '%s'." +message: "Use '%s' instead of 'make sure'." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/ProvidesAbilityTo.yml b/.vale/styles/Netwrix/ProvidesAbilityTo.yml index 6eefb213cf..1c5fcbbb4d 100644 --- a/.vale/styles/Netwrix/ProvidesAbilityTo.yml +++ b/.vale/styles/Netwrix/ProvidesAbilityTo.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'lets you' or 'can' instead of '%s'." +message: "Use '%s' instead of 'provides the ability to'." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/Utilize.yml b/.vale/styles/Netwrix/Utilize.yml index 40558aa1ac..e50ee9715e 100644 --- a/.vale/styles/Netwrix/Utilize.yml +++ b/.vale/styles/Netwrix/Utilize.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'use' instead of '%s'." +message: "Use '%s' — avoid 'utilize' and its variants." level: warning ignorecase: true swap: diff --git a/.vale/styles/Netwrix/WishTo.yml b/.vale/styles/Netwrix/WishTo.yml index cbbdcf5237..5fa1fd9b81 100644 --- a/.vale/styles/Netwrix/WishTo.yml +++ b/.vale/styles/Netwrix/WishTo.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use 'want to' instead of '%s', or rewrite as a direct imperative." +message: "Use '%s' instead of 'wish to', or rewrite as a direct imperative." level: suggestion ignorecase: true swap: diff --git a/.vale/styles/Netwrix/WordyPhrases.yml b/.vale/styles/Netwrix/WordyPhrases.yml index dfe0b1714a..d3aee592bb 100644 --- a/.vale/styles/Netwrix/WordyPhrases.yml +++ b/.vale/styles/Netwrix/WordyPhrases.yml @@ -1,5 +1,5 @@ extends: substitution -message: "Use a concise alternative instead of '%s'." +message: "Use '%s' instead of this wordy phrase." level: warning ignorecase: true swap: