Vale style audit: fix scoped warnings by mintlify[bot] · Pull Request #6900 · mintlify/docs

mintlify · 2026-08-06T16:31:25Z

Summary

Audited all 44 first-parent squash PRs merged strictly between 2026-07-30T15:06:47.361Z and 2026-08-06T15:06:41.287Z, deduplicated the CI Vale findings, and applied style-only fixes to the affected English MDX files.

Scope

In-scope merged PRs: Update from code changes: document API key IP allowlists #6421, Documentation quality check: contextual menu query type and Speakeasy verify #6752, Update from code changes: document mint dev --disable-prefetch #6764, Update from code changes: document assistant page mode #6780, Apply SEO and metadata best practices #6798, Translation lag tracker: sync es/fr/zh with July 22–29 updates #6804, Update Vale vocabulary: add terms from PR #6806 #6807, Update from code changes: document mint add-domain --basePath flag #6812, Vale style audit: fix warnings from PRs merged in the last week #6817, Update & deprecate from code: widget deflection contact form #6818, Update from code changes: widget CDN URL and CSP guidance #6820, Agent and automations UI updates #6822, Apply SEO and metadata best practices #6823, Apply brand tone and writing style fixes #6824, Fix broken links: sync translated automations/manage image references #6825, Translate content: agent + automations UI updates (#6822) #6826, Update from code changes: document window.mintlify.user for custom scripts #6827, Analytics csv export fields #6828, Translate content: analytics traffic exports section (es/fr/zh) #6831, Changelog generator: July 31, 2026 update #6833, Documentation quality check: fill reader-question gaps #6834, Impressions analytics #6838, Apply brand tone and writing style fixes #6839, Translate content: Impressions analytics section (es/fr/zh) #6840, Update Vale vocabulary: Impressions analytics terms #6841, Update from code changes: refresh assistant analytics section #6842, Update from code changes: document Tree highlight prop #6843, Document monorepo and multi-repo SDK reference setups #6844, Theme icon animation #6847, Add assistant widget to go-live checklist #6849, mint signup visibility components #6850, Documentation quality check: add SEO section to go-live checklist #6852, Update from code changes: live preview on authed sites #6853, Update from code changes: document new integrations #6858, Clean up go-live checklist #6862, Translate content: update go-live checklist #6867, Fix grammar & typos: clean checklist formatting #6869, Clarify static export beta status #6871, Add Mintlify Index documentation #6874, Translation lag tracker: sync localized August updates #6877, Update from code changes: document suggesting mode #6883, Rename widget page title #6891, Translate content: localize Mintlify Index docs #6892, and Rename Index page title #6894.
PR Update Vale vocabulary: add terms from PR #6806 #6807 includes vocabulary terms from playground updates #6806, which was not separately in scope.
Reviewed English documentation only. No translation, configuration, changelog, OpenAPI, Vale configuration, or Vale specification files were changed.

Vale findings and fixes

The authoritative CI run reported 26 suggestions across 8 files. Findings were deduplicated by file, rule, and warning text.
Fixed all safe style findings: sentence-style capitalization, active voice, semicolon usage, vocabulary suggestions for allowlists, expiration dates, style sheet, popover, and nontechnical wording for backoff.
Expanded RPC to JSON Remote Procedure Call (JSON-RPC) on first use and changed the repeated occurrence to request.
Updated the affected files: ai/model-context-protocol.mdx, api/introduction.mdx, api/search-index/introduction.mdx, assistant/configure.mdx, assistant/widget.mdx, cli/commands.mdx, customize/custom-scripts.mdx, and search-index/mcp.mdx. The broader scoped audit changes remain in the 23 English files listed in the previous PR description.

Intentional exceptions for human review

ai/model-context-protocol.mdx: retain lowercase vscode in the valid .vscode/mcp.json path.
assistant/widget.mdx: retain lowercase cloudflare and hcaptcha inside canonical URL hostnames.
search-index/mcp.mdx: retain Streamable because it is official Streamable HTTP terminology.

These five warnings were not changed because the suggested replacements would alter valid identifiers, URLs, or official terminology.