Skip to content

Vendor Vale's new Std package (groundwork, no rule changes) - #5291

Merged
Duncanma merged 1 commit into
mainfrom
vale-update-phase1
Sep 10, 2026
Merged

Vendor Vale's new Std package (groundwork, no rule changes)#5291
Duncanma merged 1 commit into
mainfrom
vale-update-phase1

Conversation

@Duncanma

@Duncanma Duncanma commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Vale 3.20 introduced Std, a shared rule library meant to de-duplicate rules Google/Microsoft both reimplement (Oxford comma, passive voice, sentence length, etc.). CI's vale-action already resolves to Vale 3.20.0 via its latest default, so it already meets Std's minimum version.
  • Vendors vale/styles/Std via vale sync and adds it to .vale.ini's Packages line, but not to BasedOnStyles — so the rules are on disk but inert. This is groundwork only; no lint behavior changes.
  • Notes the Vale 3.20+ requirement next to the Vale commands in AGENTS.md.
  • Adopting Std to replace the genuinely-overlapping Google/Microsoft rules is a deliberate follow-up, not part of this change.

Test plan

  • CI-scoped lint (vale --config .vale-ci.ini docs/) produces byte-identical output before/after (confirmed via JSON diff).
  • Full advisory lint (yarn lint) .md output byte-identical before/after; .mdx output isolated to the config change alone (same Vale binary, with/without Std in Packages) showed 2 lines of difference out of 157k+ findings, traced to pre-existing non-determinism in the repo's double-glob lint script (unrelated to this change — Std isn't referenced in BasedOnStyles anywhere).
  • vale/styles/Google, Microsoft, alex confirmed untouched — vale sync incidentally refreshes those too, so that was reverted to keep this change scoped to only the new Std package.
  • CI run on this PR (vale-ci.yml) stays green.

Vale 3.20 introduced Std, a shared rule library meant to de-duplicate
rules Google/Microsoft both reimplement (Oxford comma, passive voice,
sentence length). Vendor it via `vale sync` and bump the documented
Vale version so it's available locally, but leave it out of
BasedOnStyles for now so no lint behavior changes. Adopting Std to
replace the overlapping Google/Microsoft rules is a deliberate
follow-up.
@Duncanma
Duncanma requested a review from a team as a code owner September 9, 2026 22:42
@vercel

vercel Bot commented Sep 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
temporal-documentation Ready Ready Preview Sep 9, 2026 10:42pm UTC

Request Review

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

This PR does not change any pages in /docs. If you make updates, links to the modified pages will appear here.

@Duncanma
Duncanma merged commit d1d6c63 into main Sep 10, 2026
12 checks passed
@Duncanma
Duncanma deleted the vale-update-phase1 branch September 10, 2026 15:58
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.

2 participants