Skip to content

docs(sdk): mirror SDK reference into every locale with prefixed paths#225

Merged
wixysam merged 1 commit into
mainfrom
sdk-docs-script
Jul 9, 2026
Merged

docs(sdk): mirror SDK reference into every locale with prefixed paths#225
wixysam merged 1 commit into
mainfrom
sdk-docs-script

Conversation

@wixysam

@wixysam wixysam commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Build SDK Reference groups per language, prefixing page paths with the locale (es/, fr/, …) so each locale has its own unique page records
  • Mirror the generated English SDK reference mdx into every non-default locale directory so the prefixed paths resolve to real pages
  • Match the SDK Reference group per-language by its locale-prefixed sdk/docs/ paths (instead of globally) so translated labels are preserved

Why

Pointing multiple locales at the same un-prefixed English SDK paths made Mintlify emit each SDK page N times in llms-full.txt and caused the language switcher to bounce out of the SDK tab back to the Documentation tab. Unique per-locale paths + English-content copies fix both.

Test plan

  • Run npm run create-docs-local against paired mintlify-docs worktree
  • Inspect docs.json — each language's SDK Reference group points at its own prefixed paths
  • Verify non-default locale directories contain the mirrored SDK reference mdx
  • mintlify dev — switch language on an SDK page and confirm it stays on the SDK page (no fallback to Documentation)

🤖 Generated with Claude Code

Emit unique per-locale page paths for the SDK reference and copy the
English mdx into each non-default locale directory. Prevents duplicate
page records in llms-full.txt and fixes the language switcher falling
back to the Documentation tab instead of the in-locale SDK page.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@claude

claude Bot commented Jul 9, 2026

Copy link
Copy Markdown

Claude encountered an error —— View job


I'll analyze this and get back to you.

@wixysam wixysam merged commit d2104fe into main Jul 9, 2026
4 of 6 checks passed
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