Skip to main content

​
Internationalization

Switchbord documentation is being prepared for the same locale coverage as the app and marketing site: English, Italian, Spanish, German, French, Portuguese, and Chinese. The current public docs content remains English while the localized documentation tree is generated and reviewed. The docs site now tracks localization as an explicit documentation surface so Mintlify navigation, page parity, and translation review can be audited alongside application i18n work.

​
Locale plan

  • en is the source locale.
  • it, es, de, fr, pt, and zh are target locales.
  • Localized docs must preserve code blocks, API paths, environment variable names, product names, and MDX component syntax.
  • Internal links in localized docs should stay within the selected locale once locale directories are generated.

​
Quality gates

Before localized docs are published, each target locale must pass:
  1. Source/target page parity against the English tree.
  2. Frontmatter parity for title and description.
  3. Mintlify validation.
  4. Broken-link checks for each locale tree.
  5. Human review for legal, security, and API reference pages.

​
Implementation note

App and marketing copy are managed through JSON message bundles and Languine. Docs are MDX and require an MDX-safe translation workflow that preserves code fences, links, and component tags.