diff --git a/guides/internationalization.mdx b/guides/internationalization.mdx index 1e2f48552..50a71cda1 100644 --- a/guides/internationalization.mdx +++ b/guides/internationalization.mdx @@ -743,4 +743,13 @@ Yes. Navigation labels—group names, tab titles, anchor text—should match the Do not translate code itself—variable names, function calls, and syntax are language-agnostic. Translate comments within code blocks if they explain concepts users need to understand. Fully translate instructions surrounding code blocks. + +Mintlify serves each language version as a separate set of static pages, so a reader visiting `/es/quickstart` only loads the Spanish content for that page—not every translation. Adding languages does not change page weight or runtime performance for end users. + +Adding languages does grow your repository and your build's working set. To keep authoring and CI fast: + +* Store translated images in language-specific directories so unused locales aren't pulled into other locales' content. +* In larger repos, scope `mint broken-links` and other CI checks to changed files rather than the full tree. + +