Skip to content

Pin the Vale style packages instead of committing them - #2545

Merged
kcmartin merged 1 commit into
mainfrom
vale-pin-packages
Oct 9, 2026
Merged

kcmartin merged 1 commit into
mainfrom
vale-pin-packages

Conversation

@kcmartin

@kcmartin kcmartin commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

styles/Google, styles/proselint and styles/write-good were committed in a single import in September 2023 and never touched since, so the Google style this repo enforces is three years old by accident rather than by choice.

They do not need to be in the tree. vale sync fetches them and the action runs it by default, which is how sprites-docs works in superfly/sprites-docs#264.

Pinning by release URL keeps today's behavior exactly. I ran v0.6.3, v0.3.4 and v0.4.1 against all 532 handwritten pages and got the same 101 alerts in the same 74 files as the committed copies, because the config already disables nearly every Google rule. Tracking latest would instead add Google.WordListCase, Google.Timeless, Google.Anthropomorphism and Google.ExcessiveClaims, none of which anyone has reviewed. Moving the pins forward is now a one-line change.

Packages accepts URLs but not name@version, so the pins are full release URLs. The three directories go into .gitignore so a local vale sync does not dirty the tree.

Independent of #2544 and merges in either order. I test-merged the two: .vale.ini auto-merges with no conflict, and the combined result is the same 101 alerts.

The three public packages were committed in one import in September 2023 and
never touched since, so the Google style this repo enforces is three years
old by accident rather than by choice.

`vale sync` fetches them, and the action runs it, so they do not need to be
in the tree. Pinning by release URL keeps the behavior fixed: v0.6.3, v0.3.4
and v0.4.1 produce the same 101 alerts in the same 74 pages as the committed
copies. Tracking `latest` instead would add four Google rules nobody has
reviewed.

`Packages` accepts URLs but not name@version, so the pins are full release
URLs. Moving them forward is now a one-line change.
@mintlify

mintlify Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

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

Project Status Preview Updated
fly-io 🟢 Ready View Preview Oct 9, 2026, 9:15 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@kcmartin
kcmartin merged commit ddb982b into main Oct 9, 2026
2 checks passed
@kcmartin
kcmartin deleted the vale-pin-packages branch October 9, 2026 21:27

This branch was successfully deployed

1 active deployment
staging — ff81b825 Deployed Oct 9, 2026 by mintlify[bot]
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.

1 participant