PDOCS-3680: align Vale rules with latest style guide updates#38
Merged
PDOCS-3680: align Vale rules with latest style guide updates#38
Conversation
Update existing rules and add new rules to match the latest DigitalOcean style guide changes from product-docs. Updated rules: - ConsiderateWriting: add violent metaphors and idioms - GenderBias: add hyphenated variants - DigitalOceanTerms: add AI product terminology New rules: - EmDashes: flag en/em dashes - ExclamationMarks: warn about exclamation marks - RangeSpacing: flag spaces in ranges - ModalAuxiliaries: warn about modal verbs - VagueLinkText: flag vague link text - WordChoicePhrasalVerbs: enforce phrasal verb usage - Ellipses: warn about inappropriate ellipses - LeadingZero: require leading zero in decimals Total rules: 29 (was 21)
dfinn5-do
changed the title
dfinn5-do
commented
Feb 3, 2026
Collaborator
Author
dfinn5-do
left a comment
dfinn5-do
left a comment
There was a problem hiding this comment.
Tested and working as intended.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates Vale rules to align with the latest DigitalOcean style guide changes.
Changes
Updated Rules (3)
New Rules (8)
Total Impact
Style Guide References
All changes map to specific sections in the updated product-docs style guide:
Testing
Vale configuration validates successfully. Initial testing shows rules trigger correctly on target patterns.