PDOCS-3680: align Vale rules with latest style guide updates

styles/DigitalOcean/ConsiderateWriting.yml

@@ -12,6 +12,15 @@ swap:
     insanely: incredibly
     dummy: placeholder|stand-in|test
     stupid: foolish|ludicrous|unintelligent
-    (?:fall|fell|falling) on deaf ears: missed the mark|was ignored
+    (?:fall|fell|falling) on deaf ears: missed the mark|was ignored|were ignored
     blind spot: weakness|something we overlooked
-    sanity check: check
+    sanity check: check|verify|review
+    kill (?:a|the) (?:process|task|job): terminate|stop
+    killed (?:a|the) (?:process|task|job): terminated|stopped
+    killing (?:a|the) (?:process|task|job): terminating|stopping
+    shoot (?:an|the|a) (?:email|message): send|forward|submit
+    shot (?:an|the|a) (?:email|message): sent|forwarded|submitted
+    shooting (?:an|the|a) (?:email|message): sending|forwarding|submitting
+    tribal knowledge: existing knowledge|internal documentation
+    low-hanging fruit: early opportunity|simple task
+    white knight: system recovery

styles/DigitalOcean/DigitalOceanTerms.yml

@@ -21,3 +21,7 @@ swap:
     'Digitalocean':                     DigitalOcean
     'digitalocean^(?:.com)':            DigitalOcean
     droplet[s]?:                        Droplet(s)
+    \bspace[s]?(?! bucket| for| between| after| before| around| in):          Space(s)
+    the Gradient AI Platform:          Gradient AI Platform
+    model [Pp]layground:                Model Playground
+    agent [Pp]layground:                Agent Playground

styles/DigitalOcean/Ellipses.yml

@@ -0,0 +1,12 @@
+extends: existence
+message: "Use ellipses only to represent truncated output or omitted quoted text, not for tone or style: '%s'."
+link: https://docs.digitalocean.com/style/digitalocean/grammar/punctuation
+level: warning
+scope: sentence
+nonword: true
+# This rule flags ellipses in narrative text (not code blocks)
+# It will produce some false positives in legitimate technical uses
+# Use Vale comments to ignore specific instances if needed
+tokens:
+  - '\.\.\.'
+  - '…'  # Unicode ellipsis character

styles/DigitalOcean/EmDashes.yml

@@ -0,0 +1,8 @@
+extends: existence
+message: "Do not use en dashes (–) or em dashes (—). Use hyphens (-) for ranges and compound modifiers."
+link: https://docs.digitalocean.com/style/digitalocean/grammar/punctuation
+level: error
+nonword: true
+tokens:
+  - '–'  # en dash (U+2013)
+  - '—'  # em dash (U+2014)

styles/DigitalOcean/ExclamationMarks.yml

@@ -0,0 +1,8 @@
+extends: existence
+message: "Avoid exclamation marks in technical documentation. Rewrite for clarity instead of relying on punctuation for emphasis."
+link: https://docs.digitalocean.com/style/digitalocean/grammar/punctuation
+level: warning
+nonword: true
+scope: sentence
+tokens:
+  - '!'

styles/DigitalOcean/GenderBias.yml

@@ -21,4 +21,6 @@ swap:
     sales(?:m[ae]n|wom[ae]n):    salesperson or sales people
     work(?:m[ae]n|wom[ae]n):     worker(s)
     manhours:                    workhours
+    man-hours:                   work-hours
     manpower:                    staff
+    work(?:m[ae]n|wom[ae]n):     worker(s)

styles/DigitalOcean/LeadingZero.yml

@@ -0,0 +1,7 @@
+extends: existence
+message: "Include a leading zero for decimals less than one: '%s'."
+link: https://docs.digitalocean.com/style/digitalocean/grammar/numbers
+level: error
+nonword: true
+tokens:
+  - '(?:^|\s)\.(\d+)'  # Decimal without leading zero like " .5"

styles/DigitalOcean/ModalAuxiliaries.yml

@@ -0,0 +1,16 @@
+extends: existence
+message: "Avoid modal auxiliaries like '%s', which can confuse non-native speakers. Use direct, present-tense verbs instead."
+link: https://docs.digitalocean.com/style/digitalocean/language/verbs
+level: warning
+ignorecase: true
+tokens:
+  - '\bshould\b'
+  - '\bcould\b'
+  - '\bmay\b'
+  - '\bmight\b'
+  - '\bshould not\b'
+  - '\bcould not\b'
+  - '\bmay not\b'
+  - '\bmight not\b'
+  - '\bshouldn''t\b'
+  - '\bcouldn''t\b'

styles/DigitalOcean/RangeSpacing.yml

@@ -0,0 +1,9 @@
+extends: existence
+message: "Do not add spaces around hyphens in ranges: '%s'."
+link: https://docs.digitalocean.com/style/digitalocean/grammar/hyphens
+level: error
+nonword: true
+tokens:
+  - '\d+\s+-\s+\d+'  # numeric ranges like "10 - 20"
+  - '\d+\s+-\d+'     # "10 -20"
+  - '\d+-\s+\d+'     # "10- 20"

styles/DigitalOcean/VagueLinkText.yml

@@ -0,0 +1,16 @@
+extends: existence
+message: "Use descriptive link text. Avoid vague phrases like '%s'."
+link: https://docs.digitalocean.com/style/digitalocean/language/links-and-link-text
+level: error
+ignorecase: true
+tokens:
+  - 'click here'
+  - 'learn more'
+  - 'read more'
+  - 'more info'
+  - 'more information'
+  - 'this page'
+  - 'this link'
+  - 'here'
+  - 'click this link'
+  - 'follow this link'

styles/DigitalOcean/WordChoicePhrasalVerbs.yml

@@ -0,0 +1,11 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+link: https://docs.digitalocean.com/style/digitalocean/language/word-choice
+ignorecase: true
+level: error
+action:
+    name: replace
+swap:
+    log into: log in to
+    logged into: logged in to
+    logging into: logging in to