* docs: document auto-route to preferred language for multilingual docs
* docs: translate auto-route to preferred language section
* docs: trim auto-route to preferred language section
Cut the section down to what a user needs to turn the setting on:
what it does, the Add-ons page link, and the two behaviors that
affect them (root-only redirects, switcher choice wins).
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* 💅
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* docs: sync es/fr/zh translations for Aug 5-12 English updates
* docs: shorten SEO titles/descriptions on new translated help-center pages
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* docs: sync Mintlify skill with new component, OpenAPI file uploads, and playground JS API
* docs: split long sentence in runtime server variables section
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* Fix Vale rules instead of degrading prose
The Vale style audit workflow told the agent to make warnings go away,
with only two outcomes: fix the prose or note it in the PR body. That
produced runs that reworded correct English to satisfy an over-matching
rule, and one that replaced em dashes with colons when Mintlify.EmDash
only bans the spaces around them.
- Add a third classification to the workflow: when the prose is correct
and the rule is over-matching, fix the rule. Documents where to make
each kind of rule fix and requires explaining it in the PR body.
- Replace the "warnings left by the CI check" step. There is no Vale CI
check in this repo, so the step pointed at a source that does not
exist. Run vale against the changed files instead.
- Resolve the "a pull request for each file" ambiguity to one PR.
- Narrow the WordList `above` pattern so tier comparisons ("Pro plan and
above") are exempt. Positional references ("see above", "the app ID
above") still flag. The \b guard keeps words ending in "and" such as
"command above" and "operand above" flagged.
Verified with vale 3.12.0 against a fixture covering both the wrongly
flagged text and the text the rule must still catch.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Fold vocabulary maintenance into the weekly Vale audit
Update Vale vocabulary ran on every merge to main: six runs in about
three hours on Aug 10, four of them no-ops, and it split related terms
across separate runs because each run only saw one PR. The work also has
an ordering dependency on the style audit, which should not reword a
valid product name that the vocabulary pass ought to accept.
Adds the vocabulary pass as step 4 of the weekly audit, ahead of prose
fixes, and notes that accept.txt entries are case-sensitive regular
expressions. The previous instruction to find words "not already
present" invited a literal comparison, which would add "allowlisted" as
a new line even though allowlist(s|ed|ing)? already covers it.
Update Vale vocabulary is disabled rather than deleted; its file stays in
.mintlify/workflows/ for now.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Deprecate local workflow files; dashboard is source of truth
The .mintlify/workflows/ files had already drifted out of sync with the
automations they were supposed to define, in both directions:
- translation-lag.md was missing the entire "Check translated redirect
parity" section that exists in the dashboard record. Had a file sync
fired, it would have reverted that work.
- seo-audit.md defined an automation, "SEO and metadata audit" on a
Monday cron, that has no dashboard record and has never run. It was
still being maintained through PRs as recently as #5250.
Keeping two sources of truth for the same automation invites silent
reverts and edits to prompts that do not run. The dashboard is now the
only definition. Full backup of the four file-backed records is in the
session scratchpad; all prompt text remains in git history.
seo-audit.md is dropped rather than recreated. Fix SEO issues covers it.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* docs: add Pylon and Zendesk to support feedback automation
* docs: mirror Pylon/Zendesk support automation change to translations
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* docs: clarify PostHog API key is safe to commit
Users were avoiding committing the apiKey out of caution, unaware
it's a client-side token already exposed in every browser request.
Fixes DOC-415 / mintlify/docs#609
* 💅
mintlify[bot]