docs: sync missing translated sections across es/fr/zh by mintlify[bot] · Pull Request #5894 · mintlify/docs

mintlify · 2026-05-21T23:59:05Z

Summary

Translates sections that were present in English MDX files but missing from their Spanish, French, and Chinese counterparts. The single-commit shallow history made traditional last-commit diffing impossible, so candidates were identified by structural comparison (heading counts, component counts) between English files and translations, then verified manually.

Pages updated

Sorted by amount of missing content (most stale first).

Spanish (`es/`)

es/agent/slack.mdx — Last English update 2026-05-21. Added missing "Reconnect or reinstall the agent" subsection (with surrounding Note about workspace/org conflicts) and the entire "Ask questions about your docs" section.
es/guides/help-center.mdx — Last English update 2026-05-21. Added missing "Start from a template" section with the mint new --template snippet and template links.
es/editor/configurations.mdx — Last English update 2026-05-21. Added missing "Connect integrations" section between "Set up AI chat and search" and "API specifications".
es/ai/model-context-protocol.mdx — Last English update 2026-05-21. Added missing "Discovery endpoint" subsection (intro paragraph, JSON example, and field reference table).

French (`fr/`)

fr/agent/slack.mdx — Last English update 2026-05-21. Same gaps as Spanish: added "Reconnect or reinstall the agent" subsection (with Note) and "Ask questions about your docs" section.
fr/guides/help-center.mdx — Last English update 2026-05-21. Added "Start from a template" section.
fr/editor/configurations.mdx — Last English update 2026-05-21. Added "Connect integrations" section.
fr/ai/model-context-protocol.mdx — Last English update 2026-05-21. Added "Discovery endpoint" subsection.

Chinese (`zh/`)

zh/agent/slack.mdx — Last English update 2026-05-21. Same gaps as Spanish/French: added "Reconnect or reinstall the agent" subsection (with Note) and "Ask questions about your docs" section.
zh/organize/hidden-pages.mdx — Last English update 2026-05-21. Added "Include all hidden pages" and "Include pages under specific hidden tabs or groups" subsections under "Search, SEO, and AI indexing" (only the zh translation was missing these — es/ and fr/ already had them).
zh/guides/help-center.mdx — Last English update 2026-05-21. Added "Start from a template" section.
zh/editor/configurations.mdx — Last English update 2026-05-21. Added "Connect integrations" section.
zh/ai/model-context-protocol.mdx — Last English update 2026-05-21. Added "Discovery endpoint" subsection.

Flagged for human review

These items were not addressed in this PR — they need translator/editor attention:

Missing translation files (entire pages absent)

Each path below is missing in all three locales (es/, fr/, zh/) unless noted:

editor-classic.mdx
ai/mintlify-mcp.mdx
deploy/gitlab-self-hosted.mdx
editor/branching-and-publishing.mdx (causes 9 pre-existing broken links from editor/collaborate.mdx, editor/index.mdx, editor/live-preview.mdx in each locale)
editor/share-a-preview.mdx
editor/tutorial.mdx
workflows/create.mdx, workflows/enable.mdx, workflows/index.mdx, workflows/manage.mdx
snippets/gitlab-workflow-setup.mdx
snippets/skill-mcp-prompt.mdx
optimize/search.mdx (zh only)

Large drift not safe to translate automatically

changelog.mdx — All three locales are missing 11 headings vs English (271 vs 260). zh body is also ~50% the size of English. Likely many recent changelog entries are untranslated. Needs a dedicated translation pass.
organize/settings-reference.mdx — zh is missing 41 headings (119 vs 78) and body is ~50% the size of English. Major translation work required.

Likely content drift (component/section counts diverge, lower confidence)

These pages show component-count mismatches (steps, tabs, code blocks, notes, etc.) suggesting non-trivial content drift, but the specific gaps were not isolated this pass:

ai/contextual-menu.mdx, ai/slack-bot.mdx (zh only)
api-playground/mdx-setup.mdx, api-playground/openapi-setup.mdx
assistant/index.mdx
components/code-groups.mdx, components/examples.mdx
create/code.mdx, create/personalization.mdx
customize/fonts.mdx
deploy/authentication-setup.mdx, deploy/cloudflare.mdx, deploy/github.mdx (zh only)
editor/git-essentials.mdx (zh only), editor/navigation.mdx (zh only), editor/pages.mdx
enterprise-contracting.mdx (zh only)
guides/assistant-embed.mdx (zh only), guides/automate-agent.mdx, guides/claude-code.mdx, guides/content-types.mdx (zh only), guides/cursor.mdx (es only), guides/improving-docs.mdx (zh only), guides/maintenance.mdx (zh only), guides/media.mdx (zh only), guides/navigation.mdx (zh only), guides/understand-your-audience.mdx (zh only)
Several api/... reference pages (heading counts differ — possibly fine since OpenAPI-derived)
integrations/analytics/* and integrations/support/intercom.mdx, integrations/privacy/osano.mdx (code block counts differ)
migration.mdx
optimize/analytics.mdx (zh only), optimize/seo.mdx
organize/navigation.mdx
quickstart.mdx
snippets/custom-subpath-propagating.mdx (zh only)

Notes

Single-commit shallow git history prevented running a true commit-diff analysis. Candidates were identified by comparing the structural shape of each English file to its translations.
mint validate passes. mint broken-links reports 9 pre-existing broken links pointing to the missing editor/branching-and-publishing translations (listed above).

Note

Low Risk
Low risk documentation-only changes that add missing translated sections; primary risk is minor translation/formatting drift or broken anchors/links.

Overview
Adds previously missing translated sections to Spanish, French, and Chinese docs to better match the English originals.

Updates Slack agent guides with workspace/org conflict guidance plus a new reconnect/reinstall subsection and a new ask questions about your docs section; expands MCP docs with a new /.well-known/mcp discovery-endpoint section (JSON example + field table); adds a short connect integrations section to editor configuration docs; adds a start from a template section to help-center guides; and expands Chinese hidden-pages docs with new options for indexing hidden content (site-wide vs searchable: true on hidden tabs/groups).

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

mintlify-development · 2026-05-21T23:59:10Z