Skip to content

Lint MDX pages with Vale - #2544

Merged
kcmartin merged 1 commit into
mainfrom
vale-lint-mdx
Oct 9, 2026
Merged

kcmartin merged 1 commit into
mainfrom
vale-lint-mdx

Conversation

@kcmartin

@kcmartin kcmartin commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

.vale.ini has matched *.markerb and *md since before the cutover, so no .mdx page has been linted. Vale has been running on every PR and finding nothing to apply rules to.

Checked with Vale 3.9.1 and this repo's own styles: byte-identical content in probe.md and probe.mdx gave 1 alert and 0. With the two lines here, both give 1.

Fly.Spelling goes off in the same commit. It accounts for 663 of the 764 alerts the fix surfaces, and the words are redis, Ecto, tcp, Lua, rsync and example identifiers like mypostgres, so it wants a vocabulary pass rather than page edits. With it off the repo reports 101 alerts across 74 pages, 76 of them Fly.WordList.

Nothing starts failing. The workflow sets fail_on_error: false, so Vale annotates and does not block.

sprites-docs is broken too, for an unrelated reason, and needs its own fix.

The only rule section matched `*.markerb` and `*md`, so no `.mdx` page has
been linted since the cutover. Vale ran on every docs PR and found nothing
to apply rules to.

Fly.Spelling stays off until the vocabulary covers these pages. It is 663 of
the 764 alerts the fix surfaces, and the words are overwhelmingly product
and tool names rather than mistakes.
@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, 8:41 PM

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

@kcmartin
kcmartin merged commit 0fc1a74 into main Oct 9, 2026
2 checks passed
@kcmartin
kcmartin deleted the vale-lint-mdx branch October 9, 2026 21:30
@kcmartin kcmartin mentioned this pull request Oct 9, 2026

This branch was successfully deployed

1 active deployment
staging — 07c4ffe9 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