Skip to content

Add missing technical terms to Vale vocabulary#5268

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/vale-vocab-1775781302
Open

Add missing technical terms to Vale vocabulary#5268
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/vale-vocab-1775781302

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 10, 2026

Summary

Adds 18 technical terms, product names, and abbreviations to the Vale spelling vocabulary that appear in the English documentation prose but were not yet in accept.txt.

New entries

  • Product names: Ahrefs, Astro, Devin, Shiki, Splunk, Squoosh, SVGR
  • Technical terms: autocomplete, linter/linting, regex, revalidate/revalidation, deduplicated (extended existing pattern)
  • Abbreviations: PST, ROI, RTL, URIs, UTF, JWTs (extended JWT to JWTs?)

Modified entries

  • deduplication(?i)deduplic(ated?|ation) to cover "deduplicated"
  • JWTJWTs? to cover the plural form

Note

Low Risk
Low risk: only updates the Vale accepted-words list to reduce false-positive spelling/style lint warnings; no runtime code paths are affected.

Overview
Expands the Vale Mintlify accepted vocabulary (.vale/styles/config/vocabularies/Mintlify/accept.txt) with additional technical terms, product names, and abbreviations seen in docs.

Also broadens existing entries to cover common variants by changing deduplication to (?i)deduplic(ated?|ation) and JWT to JWTs?.

Reviewed by Cursor Bugbot for commit b28ebb2. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 10, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 10, 2026, 12:40 AM

Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit b28ebb2. Configure here.

res
REST
resubmit
revalidat(e|ion)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Regex misses "revalidates" found in documentation prose

Medium Severity

The pattern revalidat(e|ion) matches "revalidate" and "revalidation" but not "revalidates", which appears in deploy/github.mdx alt text (e.g., "the green check mark that revalidates the repository settings"). The alternation needs to include the third-person singular form — something like revalidat(es?|ion) — to avoid a false positive Vale warning for that existing word.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b28ebb2. Configure here.

Linear
LinkedIn
Linux
(?i)lint(er|ing)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Regex misses "linters" found in documentation prose

Medium Severity

The pattern (?i)lint(er|ing) matches "linter" and "linting" but not "linters", which appears in guides/style-and-tone.mdx (e.g., "Run Vale or other linters on every pull request"). The alternation needs to account for the plural form — something like (?i)lint(ers?|ing) — to prevent a false positive Vale warning.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b28ebb2. Configure here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants