Skip to content

docs: sync translation lag in es/fr/zh localized pages#6064

Merged
ethanpalm merged 2 commits into
mainfrom
mintlify/20b00896
Jun 3, 2026
Merged

docs: sync translation lag in es/fr/zh localized pages#6064
ethanpalm merged 2 commits into
mainfrom
mintlify/20b00896

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

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 *.mdx and its es/, fr/, and zh/ 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 workflow section (with mint workflow create, mint workflow list, mint workflow delete subcommands, shared flag table, examples, and YAML workflow file shape). The English file documents these commands but the zh translation jumped from mint analytics straight to mint 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 entire background.color/background.image tree, styling.codeblocks.theme/languages, the entire thumbnails block, errors.404.redirect/title/description, api.url, the entire api.mdx tree, etc.). 941 EN lines vs 646 zh lines. Too large to translate safely without human review.
  • zh/ai/skillmd.mdx — Added the missing ## Agent card section covering the /.well-known/agent-card.json endpoint, 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 spec section (contextual menu config, download-spec JSON example, auth/userAuth behavior). es/fr already have this section.
  • zh/ai/markdown-export.mdx — Added the missing ## Authentication section with the .md URL authentication-mode table. es/fr already have this section.
  • zh/create/text.mdx — Added the missing ## Comments section 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.mdx and the importing destination file).
  • zh/optimize/seo.mdx — Expanded ### Set a canonical URL into Global canonical + Per-page canonical subsections (with frontmatter YAML example and the <Note> about /src/_props), and added the missing canonical bullet to the per-page meta tag list.
  • zh/quickstart.mdx — Removed the stale <Tip> about replacing github.com with mintlify.com (the English source removed this).
  • zh/changelog.mdx (flagged, not edited) — Missing the entire May 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 previous Modo visual/Modo Markdown/Personaliza la apariencia structure). Needs human translation.
  • zh/organize/navigation.mdx (flagged, not edited) — English ## Languages section 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 replacing github.com with mintlify.com (deleted from English source).
  • es/changelog.mdx (flagged, not edited) — Missing the May 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 replacing github.com with mintlify.com (deleted from English source).
  • fr/changelog.mdx (flagged, not edited) — Missing the May 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, zh
  • editor/branching-and-publishing.mdx — missing in es, fr, zh
  • editor/share-a-preview.mdx — missing in es, fr, zh
  • editor/tutorial.mdx — missing in es, fr, zh
  • snippets/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, zh
  • ai/mintlify-mcp.mdx — missing in zh
  • credits.mdx — missing in zh
  • guides/use-workflows.mdx — missing in zh
  • optimize/search.mdx — missing in zh
  • workflows/{create,index,manage,reference}.mdx — missing in zh

Validation

  • mint validate — only the pre-existing docs.json download-spec enum warning, unchanged by this PR.
  • mint broken-links — clean (the new mint workflow section in zh/cli/commands.mdx links to /workflows since zh/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 into mintlify.com explore links; fr also tightens the page description.

Chinese catch-up: Adds translated sections that already existed in English (and often in es/fr)—including mint workflow CLI reference, Markdown export authentication table, skill.md Agent card (A2A), OpenAPI download-spec contextual menu, reusable snippet variable interpolation in fenced code blocks, MDX {/* */} comments, and expanded SEO canonical (global vs per-page + frontmatter canonical).

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.

@mintlify

mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jun 3, 2026, 3:48 PM

@mintlify

mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
smartac 🟢 Ready View Preview Jun 3, 2026, 4:20 PM

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

@mintlify

mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
testsignup415 🟢 Ready View Preview Jun 3, 2026, 4:33 PM

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

@mintlify

mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
adminroletesting 🟢 Ready View Preview Jun 3, 2026, 4:42 PM

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

@mintlify

mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
hfh-d7a4d643 🟢 Ready View Preview Jun 3, 2026, 4:50 PM

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

@mintlify

mintlify Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
gwgwgw 🟢 Ready View Preview Jun 3, 2026, 4:58 PM

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

@ethanpalm ethanpalm merged commit a61aef4 into main Jun 3, 2026
5 checks passed
@ethanpalm ethanpalm deleted the mintlify/20b00896 branch June 3, 2026 19:54
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.

2 participants