docs: sync translation lag in es/fr/zh localized pages#6064
Merged
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
ethanpalm
approved these changes
Jun 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Catches up es/fr/zh translations where the English source had newer content (missing sections, code blocks, list items) and removes a stale Tip that was deleted from the English
quickstart.mdx.Context
This repository has a single root commit, so per-file git timestamps could not be used to compute translation lag. Candidates were identified by comparing structural signals (heading counts, code-block counts, component opens) between each English
*.mdxand itses/,fr/, andzh/counterpart, then verified by inspecting the actual diff. Pure style/punctuation/whitespace differences and the localized<div id="...">heading-wrapper pattern were treated as "no action needed."Changes
Sorted by staleness — pages with the most missing content first. All translated additions follow the existing
<div id="...">wrapper convention used throughout the localized files.Chinese (zh) — most stale
zh/cli/commands.mdx— Added the entire## mint workflowsection (withmint workflow create,mint workflow list,mint workflow deletesubcommands, shared flag table, examples, and YAML workflow file shape). The English file documents these commands but the zh translation jumped frommint analyticsstraight tomint config.zh/organize/settings-reference.mdx(flagged, not edited) — zh is missing ~40 reference subsections (navigation.global.tabs/anchors/dropdowns/versions/products,navigation.versions/tabs/anchors/dropdowns/products/groups/pages,favicon.light/dark,fonts.heading/body, the entirebackground.color/background.imagetree,styling.codeblocks.theme/languages, the entirethumbnailsblock,errors.404.redirect/title/description,api.url, the entireapi.mdxtree, etc.). 941 EN lines vs 646 zh lines. Too large to translate safely without human review.zh/ai/skillmd.mdx— Added the missing## Agent cardsection covering the/.well-known/agent-card.jsonendpoint, A2A schema fields table, custom-domain behavior, reverse-proxy<Note>, and MCP cross-reference.zh/api-playground/openapi-setup.mdx— Added the missing## Let visitors download your specsection (contextual menu config,download-specJSON example,auth/userAuthbehavior). es/fr already have this section.zh/ai/markdown-export.mdx— Added the missing## Authenticationsection with the.mdURL authentication-mode table. es/fr already have this section.zh/create/text.mdx— Added the missing## Commentssection covering{/* ... */}MDX comment syntax and the<Warning>against<!-- ... -->.zh/create/reusable-snippets.mdx— Added the missing "Variables also interpolate inside fenced code blocks" paragraph plus the two example code blocks (shared/install-snippet.mdxand the importing destination file).zh/optimize/seo.mdx— Expanded### Set a canonical URLinto Global canonical + Per-page canonical subsections (with frontmatter YAML example and the<Note>about/src/_props), and added the missingcanonicalbullet to the per-page meta tag list.zh/quickstart.mdx— Removed the stale<Tip>about replacinggithub.comwithmintlify.com(the English source removed this).zh/changelog.mdx(flagged, not edited) — Missing the entireMay 29, 2026<Update>entry (Editor, Editor agent, Workflows, API playground, Admin MCP, Agent discoverability, Improvements, Bug fixes sections). Translating a ~70-bullet release note is too large for an automated pass.zh/editor/pages.mdx(flagged, not edited) — English file was substantially rewritten (new headings:Block actions,Table of contents,Code block options,Pages deleted via Git,Add media,Images and videos,Light and dark image variants,Embed external media; replaces previousModo visual/Modo Markdown/Personaliza la aparienciastructure). Needs human translation.zh/organize/navigation.mdx(flagged, not edited) — English## Languagessection converted from<CardGroup>to a Markdown table of language codes. zh still uses the CardGroup format.Spanish (es)
es/quickstart.mdx— Removed the stale<Tip>about replacinggithub.comwithmintlify.com(deleted from English source).es/changelog.mdx(flagged, not edited) — Missing theMay 29, 2026<Update>entry. Needs human translation.es/editor/pages.mdx(flagged, not edited) — Same rewrite as zh above. Needs human translation.es/organize/navigation.mdx(flagged, not edited) — Same CardGroup → table change as zh.French (fr)
fr/quickstart.mdx— Removed the stale<Tip>about replacinggithub.comwithmintlify.com(deleted from English source).fr/changelog.mdx(flagged, not edited) — Missing theMay 29, 2026<Update>entry. Needs human translation.fr/editor/pages.mdx(flagged, not edited) — Same rewrite as zh. Needs human translation.fr/organize/navigation.mdx(flagged, not edited) — Same CardGroup → table change as zh.Missing files (flagged for human review)
Translations for these English pages do not exist at all. Creating them is out of scope for this lag-sync pass:
deploy/gitlab-self-hosted.mdx— missing in es, fr, zheditor/branching-and-publishing.mdx— missing in es, fr, zheditor/share-a-preview.mdx— missing in es, fr, zheditor/tutorial.mdx— missing in es, fr, zhsnippets/counter.mdx,snippets/custom-subpath-propagating.mdx,snippets/gitlab-workflow-setup.mdx,snippets/icons-optional.mdx,snippets/icons-required.mdx,snippets/skill-mcp-prompt.mdx,snippets/vercel-json-generator.mdx— missing in es, fr, zhai/mintlify-mcp.mdx— missing in zhcredits.mdx— missing in zhguides/use-workflows.mdx— missing in zhoptimize/search.mdx— missing in zhworkflows/{create,index,manage,reference}.mdx— missing in zhValidation
mint validate— only the pre-existingdocs.jsondownload-specenum warning, unchanged by this PR.mint broken-links— clean (the newmint workflowsection inzh/cli/commands.mdxlinks to/workflowssincezh/workflows/does not exist; matches how other zh pages reference English-only sections).Note
Low Risk
Documentation-only localized MDX edits with no application, auth, or deployment logic changes.
Overview
Brings es, fr, and zh localized docs closer to English by adding missing sections and removing content that English no longer includes.
Quickstart (es/fr/zh): Drops the obsolete
<Tip>about turning public GitHub URLs intomintlify.comexplore links; fr also tightens the pagedescription.Chinese catch-up: Adds translated sections that already existed in English (and often in es/fr)—including
mint workflowCLI reference, Markdown export authentication table,skill.mdAgent card (A2A), OpenAPIdownload-speccontextual menu, reusable snippet variable interpolation in fenced code blocks, MDX{/* */}comments, and expanded SEO canonical (global vs per-page + frontmattercanonical).No product/runtime code changes—docs-only translation sync.
Reviewed by Cursor Bugbot for commit 232845f. Bugbot is set up for automated code reviews on this repo. Configure here.