Skip to content

docs: address user feedback on tiles and i18n pages #6290

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ethanpalm merged 3 commits into from
Jun 26, 2026
Merged

docs: address user feedback on tiles and i18n pages #6290

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
22a1734
docs: address user feedback on tiles and i18n pages
mintlify[bot] Jun 26, 2026
1a8bca0
Apply suggestion from @ethanpalm
ethanpalm Jun 26, 2026
23b048b
Apply suggestion from @ethanpalm
ethanpalm Jun 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions guides/internationalization.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -662,11 +662,11 @@

```
images/
├── dashboard.png # English version

Check warning on line 665 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L665 

Use 'PNG' instead of 'png'.
├── fr/
│ └── dashboard.png # French version

Check warning on line 667 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L667 

Use 'PNG' instead of 'png'.
└── es/
└── dashboard.png # Spanish version

Check warning on line 669 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L669 

Use 'PNG' instead of 'png'.
```

Reference images using relative paths in your translated content.
Expand Down Expand Up @@ -743,4 +743,13 @@
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.
</Accordion>

<Accordion title="Does adding more languages affect site performance?">
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.
</Accordion>

</AccordionGroup>
Loading