Vale style audit: fix warnings from PRs merged in the last week by mintlify[bot] · Pull Request #6278 · mintlify/docs

mintlify · 2026-06-25T15:25:27Z

Summary

Audits Vale style warnings introduced by the 33 PRs merged into main between 2026-06-18 and 2026-06-25 (scope window from the vale-audit workflow) and applies confident, style-only fixes.

Changes

advanced-support.mdx — WordList: lowercase Email → email in the support tiers table cell (L14).
create/changelogs.mdx — WordList: lowercase Email → email in the RSS integrations bullet link label (L139).
ai/model-context-protocol.mdx — EmDash: remove spaces around em-dash in the 4 tool annotation bullets (L173–L176).
guides/seo.mdx — EmDash: remove spaces around em-dash in 4 SEO FAQ sentences (L149, L161, L165, L169).
optimize/seo.mdx — EmDash: remove spaces around em-dash in the 3 Content-Signal opt-in bullets (L353–L355).
organize/settings-structure.mdx — EmDash: remove spaces around em-dash in 20 contextual menu option bullets and $page / $path / $mcp placeholder bullets (L379–L395, L413–L415).

Total: 33 style-only corrections across 6 files.

Context

Triggered by .mintlify/workflows/vale-audit.md (scheduled run, window 2026-06-18T15:06:57Z → 2026-06-25T15:06:50Z).
Mirrors the precedent set by PR docs: fix Vale warnings from PRs merged in the last week #6222.
Only English .mdx files were considered. Files under es/, fr/, zh/, and changelog.mdx are out of scope per the workflow.
Rules implemented: WordList, Latin, Spelling, EmDash, Spacing, Ellipses, LyHyphens, OptionalPlurals, Ordinal, HeadingPunctuation (applied against .vale.ini SkippedScopes: fenced code, JSX tags, expressions, inline code, frontmatter, markdown link URLs).

Warnings left for human review

`WordList` — `regex` → `regular expression`

dashboard/sso.mdx L178 — | \groups` | Unspecified | Matches regex | `.*` |`

The cell value Matches regex is a literal Okta SAML attribute-statement filter option (Matches regex is the exact label in the Okta admin UI). Rewriting to regular expression would misrepresent the product label, so this needs a human call.

Warnings inspected and dismissed as false positives

These were flagged by the lint pass but resolved as masking artifacts or scoping issues and not changed:

ai/markdown-export.mdx L70 — Spacing flagged a double-space artifact created by masking inline code (`.md`) between a sentence-ending period and the next capitalized word. The original source has a single space.
ai/model-context-protocol.mdx L410 — WordList flagged url inside an indented ```toml fenced code block (url = "<your-mcp-server-url>"), which is in scope per .vale.ini SkippedScopes = code.
deploy/authentication-setup.mdx L88, L93, L103, L104, L131 — WordList flagged OAuth 2 inside OAuth 2.0. The text already conforms to the rule (OAuth 2.0).

Note

Low Risk
Documentation-only punctuation and word-list capitalization with no runtime or configuration impact.

Overview
This PR applies Vale style-only fixes from a recent audit: mainly EmDash (tighten em dashes by dropping spaces around —) and a WordList tweak.

Em dash formatting is updated on bullet lists and in running copy—MCP tool annotation bullets, SEO FAQ answers, Content-Signal / noindex bullets, and long contextual.options lists in site-structure docs. The pattern changes from spaced em dashes (—) to unspaced (—) before the gloss text.

The same em-dash pass is mirrored in es/, fr/, and zh/ localized pages (MCP, SEO guides, SEO reference, settings structure). zh/create/changelogs.mdx also lowercases Email to email in an RSS integration bullet link label.

No product behavior, APIs, or config semantics change—only documentation punctuation and capitalization for the style linter.

^{Reviewed by Cursor Bugbot for commit a148205. Bugbot is set up for automated code reviews on this repo. Configure here.}

mintlify · 2026-06-25T15:37:31Z