Skip to content

Add external translation provider workflow guide#3461

Merged
ethanpalm merged 5 commits intomainfrom
external-translation-workflow-1771018508
Mar 6, 2026
Merged

Add external translation provider workflow guide#3461
ethanpalm merged 5 commits intomainfrom
external-translation-workflow-1771018508

Conversation

@mintlify
Copy link
Contributor

@mintlify mintlify bot commented Feb 13, 2026

Summary

Adds documentation for teams using their own translation providers (external vendors, regional translators) to work with Mintlify documentation.

  • Workflow overview for export/import translation cycles
  • GitHub Actions examples for automating content export and translation import
  • Best practices for working with external translators (frontmatter, code blocks, glossaries)

Addresses the need outlined in DOC-263 for customers like Notion who work with different regional translators and need guidance on getting MDX files to/from their translation providers.


Note

Low Risk
Low risk: documentation-only updates that don’t change runtime code paths. Main risk is users copying the example GitHub Actions workflows without adapting language paths and validation to their repo.

Overview
Adds an external translation provider section to guides/internationalization.mdx, outlining an export/send/receive/import workflow for working with third-party translators.

Includes copy-pastable GitHub Actions examples to (1) export changed source .mdx files on merges to main and (2) validate incoming translated PRs (frontmatter presence and basic source/translation structure checks), plus a small fix to the supported Chinese language code entry (zh/zh-Hans).

Written by Cursor Bugbot for commit acd2cfa. This will update automatically on new commits. Configure here.

- Preserve directory structure in export package using mkdir -p + relative path
- Quote \$lang variable in find command

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ethanpalm ethanpalm merged commit 5c9689a into main Mar 6, 2026
5 checks passed
@ethanpalm ethanpalm deleted the external-translation-workflow-1771018508 branch March 6, 2026 18:02
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.

1 participant