From 22a17344e5b22b2833567f4a767f71db83a11cd0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 26 Jun 2026 00:03:21 +0000 Subject: [PATCH 1/3] docs: address user feedback on tiles and i18n pages --- components/tiles.mdx | 4 ++++ guides/internationalization.mdx | 10 ++++++++++ 2 files changed, 14 insertions(+) diff --git a/components/tiles.mdx b/components/tiles.mdx index a7d02920bd..b33134c14d 100644 --- a/components/tiles.mdx +++ b/components/tiles.mdx @@ -7,6 +7,10 @@ boost: 3 Use tiles to create visual showcase elements with a patterned background, title, and description. Tiles are ideal for displaying component previews, feature highlights, or navigation items in a grid layout. + + The examples on this page use SVG previews of the [Accordion component](/components/accordions) to illustrate how tile images render. In your own docs, replace these with any image, illustration, or screenshot that represents what you're linking to. + + Accordion component preview Accordion component preview (dark mode) diff --git a/guides/internationalization.mdx b/guides/internationalization.mdx index 1e2f48552d..668605c273 100644 --- a/guides/internationalization.mdx +++ b/guides/internationalization.mdx @@ -743,4 +743,14 @@ 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: + +* Translate only the pages your audience needs rather than mirroring every page in every language. +* 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. + + From 1a8bca0639181f277c60fbe2dffc22ed784ecc55 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 25 Jun 2026 17:04:21 -0700 Subject: [PATCH 2/3] Apply suggestion from @ethanpalm --- components/tiles.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/components/tiles.mdx b/components/tiles.mdx index b33134c14d..a7d02920bd 100644 --- a/components/tiles.mdx +++ b/components/tiles.mdx @@ -7,10 +7,6 @@ boost: 3 Use tiles to create visual showcase elements with a patterned background, title, and description. Tiles are ideal for displaying component previews, feature highlights, or navigation items in a grid layout. - - The examples on this page use SVG previews of the [Accordion component](/components/accordions) to illustrate how tile images render. In your own docs, replace these with any image, illustration, or screenshot that represents what you're linking to. - - Accordion component preview Accordion component preview (dark mode) From 23b048b19fa05f75a5a3562335ffa570c84bd864 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 25 Jun 2026 17:04:59 -0700 Subject: [PATCH 3/3] Apply suggestion from @ethanpalm --- guides/internationalization.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/guides/internationalization.mdx b/guides/internationalization.mdx index 668605c273..50a71cda15 100644 --- a/guides/internationalization.mdx +++ b/guides/internationalization.mdx @@ -748,7 +748,6 @@ Mintlify serves each language version as a separate set of static pages, so a re Adding languages does grow your repository and your build's working set. To keep authoring and CI fast: -* Translate only the pages your audience needs rather than mirroring every page in every language. * 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.