From c53c039517dd1273ea5fa03202860ba1bbf8f80a Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 15:20:32 +0000 Subject: [PATCH 1/3] Add translation status report Generated-By: mintlify-agent --- TRANSLATION_STATUS.md | 76 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 TRANSLATION_STATUS.md diff --git a/TRANSLATION_STATUS.md b/TRANSLATION_STATUS.md new file mode 100644 index 000000000..8c985e788 --- /dev/null +++ b/TRANSLATION_STATUS.md @@ -0,0 +1,76 @@ +# Translation status report + +This report identifies pages where the English source has been updated more recently than its translations. + +**Report generated:** 2026-03-11 + +## Summary + +- **Total English pages:** 184 +- **Spanish (es/) out of sync:** 7 pages +- **French (fr/) out of sync:** 12 pages +- **Chinese (zh/) out of sync:** 9 pages +- **Missing translations:** None + +--- + +## Spanish (es/) + +Pages listed by staleness (most out of date first). + +| Page | English updated | Days behind | Change summary | +|------|-----------------|-------------|----------------| +| `guides/seo.mdx` | 2026-03-03 | 108 | Move period inside quotation marks | +| `components/view.mdx` | 2026-02-24 | 77 | Convert future tense to present tense | +| `guides/accessibility.mdx` | 2026-02-24 | 32 | Convert future tense to present tense | +| `integrations/analytics/overview.mdx` | 2026-03-05 | 5 | Fix Vale style warnings | +| `agent/workflows.mdx` | 2026-03-10 | <1 | Add Slack notification docs for workflows | +| `ai-native.mdx` | 2026-03-02 | <1 | Fix Vale style issues | +| `integrations/analytics/hotjar.mdx` | 2026-03-05 | <1 | Fix Vale style warnings | + +--- + +## French (fr/) + +Pages listed by staleness (most out of date first). + +| Page | English updated | Days behind | Change summary | +|------|-----------------|-------------|----------------| +| `guides/seo.mdx` | 2026-03-03 | 108 | Move period inside quotation marks | +| `guides/understand-your-audience.mdx` | 2026-02-26 | 104 | Convert future tense to present tense | +| `guides/accessibility.mdx` | 2026-02-24 | 32 | Convert future tense to present tense | +| `migration-services/enterprise.mdx` | 2026-03-03 | 10 | Replace 'will' with present tense | +| `guides/migrating-from-mdx.mdx` | 2026-02-24 | 6 | Convert future tense to present tense | +| `integrations/analytics/overview.mdx` | 2026-03-05 | 5 | Fix Vale style warnings | +| `migration-services/pro.mdx` | 2026-02-24 | 3 | Replace functionality with simpler terms | +| `agent/workflows.mdx` | 2026-03-10 | <1 | Add Slack notification docs for workflows | +| `ai-native.mdx` | 2026-03-02 | <1 | Fix Vale style issues | +| `components/expandables.mdx` | 2026-03-05 | <1 | Fix Vale style warnings | +| `guides/content-types.mdx` | 2026-02-25 | <1 | Replace 'functionality' with preferred terms | +| `integrations/analytics/hotjar.mdx` | 2026-03-05 | <1 | Fix Vale style warnings | + +--- + +## Chinese (zh/) + +Pages listed by staleness (most out of date first). + +| Page | English updated | Days behind | Change summary | +|------|-----------------|-------------|----------------| +| `guides/seo.mdx` | 2026-03-03 | 108 | Move period inside quotation marks | +| `guides/auth0.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | +| `guides/geo.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | +| `guides/maintenance.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | +| `guides/navigation.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | +| `components/view.mdx` | 2026-02-24 | 77 | Convert future tense to present tense | +| `guides/accessibility.mdx` | 2026-02-24 | 32 | Convert future tense to present tense | +| `ai/discord.mdx` | 2026-02-24 | 25 | Convert future tense to present tense | +| `agent/workflows.mdx` | 2026-03-10 | <1 | Add Slack notification docs for workflows | + +--- + +## Notes for translators + +Most out-of-sync pages involve Vale style fixes (future tense to present tense, punctuation placement). These are typically minor wording adjustments rather than structural content changes. + +The `agent/workflows.mdx` update is a content addition (Slack notification documentation) that requires translation of new material. From a7566f3d7cfe7e2129ec25cce58e6bdd9f418f62 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Mar 2026 11:21:24 -0700 Subject: [PATCH 2/3] Improve translation lag workflow to filter style-only English changes Update the prompt to inspect actual diffs rather than just comparing modification dates. The workflow now classifies changes as requiring translation (new/changed content) or not (Vale style fixes, punctuation, tense corrections) and only flags pages that genuinely need translator action. Co-Authored-By: Claude Sonnet 4.6 --- .mintlify/workflows/translation-lag.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/.mintlify/workflows/translation-lag.md b/.mintlify/workflows/translation-lag.md index 39a4e3478..963b02d0f 100644 --- a/.mintlify/workflows/translation-lag.md +++ b/.mintlify/workflows/translation-lag.md @@ -4,13 +4,19 @@ on: cron: "3 15 * * 3" --- -Compare the English MDX files in the the repo against their counterparts in the `es/`, `fr/`, and `zh/` subdirectories. Use git history to identify English files that have been updated more recently than their translations. +Compare the English MDX files in the repo against their counterparts in the `es/`, `fr/`, and `zh/` subdirectories. Use git history to find English files updated more recently than their translations. -Open a pull request that lists pages that are out of sync, organized by language. For each page, include the date of the last English update and a brief summary of what changed so translators have context on what to update. +For each candidate file, inspect the actual diff between the English file's last commit and the translation's last commit. Classify each change: -Success criteria: Any discrepancies between the English and translated files are identified and listed in the pull request. +- **Needs translation**: New or changed prose, headings, UI labels, or structured content (tables, steps) that translators must update. Flag these. +- **No action needed**: English-only style fixes that don't apply to translated text — punctuation rules (period placement inside quotes), tense corrections, Vale style warnings, whitespace, or code-only changes. Do not flag these. + +Open a pull request listing only the pages that genuinely need translation work, organized by language and sorted by staleness (most stale first). For each flagged page, include the date of the last English update and a brief description of what content needs to be translated. + +Success criteria: Every flagged page has a content change that a translator actually needs to act on. Pages where only English style fixes were applied are excluded. ## Important - If a translated file does not exist at all, flag it as missing rather than out of sync -- Group findings by language, then by how far out of date they are (most stale first) +- If all changes to an English file since the translation's last update are style-only, skip it entirely +- When in doubt about whether a change requires translation, err on the side of flagging it From c79eb3d9c8d97e01a6c2ef9516734a1e49c7e569 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Mar 2026 11:21:56 -0700 Subject: [PATCH 3/3] remove temp file --- TRANSLATION_STATUS.md | 76 ------------------------------------------- 1 file changed, 76 deletions(-) delete mode 100644 TRANSLATION_STATUS.md diff --git a/TRANSLATION_STATUS.md b/TRANSLATION_STATUS.md deleted file mode 100644 index 8c985e788..000000000 --- a/TRANSLATION_STATUS.md +++ /dev/null @@ -1,76 +0,0 @@ -# Translation status report - -This report identifies pages where the English source has been updated more recently than its translations. - -**Report generated:** 2026-03-11 - -## Summary - -- **Total English pages:** 184 -- **Spanish (es/) out of sync:** 7 pages -- **French (fr/) out of sync:** 12 pages -- **Chinese (zh/) out of sync:** 9 pages -- **Missing translations:** None - ---- - -## Spanish (es/) - -Pages listed by staleness (most out of date first). - -| Page | English updated | Days behind | Change summary | -|------|-----------------|-------------|----------------| -| `guides/seo.mdx` | 2026-03-03 | 108 | Move period inside quotation marks | -| `components/view.mdx` | 2026-02-24 | 77 | Convert future tense to present tense | -| `guides/accessibility.mdx` | 2026-02-24 | 32 | Convert future tense to present tense | -| `integrations/analytics/overview.mdx` | 2026-03-05 | 5 | Fix Vale style warnings | -| `agent/workflows.mdx` | 2026-03-10 | <1 | Add Slack notification docs for workflows | -| `ai-native.mdx` | 2026-03-02 | <1 | Fix Vale style issues | -| `integrations/analytics/hotjar.mdx` | 2026-03-05 | <1 | Fix Vale style warnings | - ---- - -## French (fr/) - -Pages listed by staleness (most out of date first). - -| Page | English updated | Days behind | Change summary | -|------|-----------------|-------------|----------------| -| `guides/seo.mdx` | 2026-03-03 | 108 | Move period inside quotation marks | -| `guides/understand-your-audience.mdx` | 2026-02-26 | 104 | Convert future tense to present tense | -| `guides/accessibility.mdx` | 2026-02-24 | 32 | Convert future tense to present tense | -| `migration-services/enterprise.mdx` | 2026-03-03 | 10 | Replace 'will' with present tense | -| `guides/migrating-from-mdx.mdx` | 2026-02-24 | 6 | Convert future tense to present tense | -| `integrations/analytics/overview.mdx` | 2026-03-05 | 5 | Fix Vale style warnings | -| `migration-services/pro.mdx` | 2026-02-24 | 3 | Replace functionality with simpler terms | -| `agent/workflows.mdx` | 2026-03-10 | <1 | Add Slack notification docs for workflows | -| `ai-native.mdx` | 2026-03-02 | <1 | Fix Vale style issues | -| `components/expandables.mdx` | 2026-03-05 | <1 | Fix Vale style warnings | -| `guides/content-types.mdx` | 2026-02-25 | <1 | Replace 'functionality' with preferred terms | -| `integrations/analytics/hotjar.mdx` | 2026-03-05 | <1 | Fix Vale style warnings | - ---- - -## Chinese (zh/) - -Pages listed by staleness (most out of date first). - -| Page | English updated | Days behind | Change summary | -|------|-----------------|-------------|----------------| -| `guides/seo.mdx` | 2026-03-03 | 108 | Move period inside quotation marks | -| `guides/auth0.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | -| `guides/geo.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | -| `guides/maintenance.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | -| `guides/navigation.mdx` | 2026-02-24 | 101 | Convert future tense to present tense | -| `components/view.mdx` | 2026-02-24 | 77 | Convert future tense to present tense | -| `guides/accessibility.mdx` | 2026-02-24 | 32 | Convert future tense to present tense | -| `ai/discord.mdx` | 2026-02-24 | 25 | Convert future tense to present tense | -| `agent/workflows.mdx` | 2026-03-10 | <1 | Add Slack notification docs for workflows | - ---- - -## Notes for translators - -Most out-of-sync pages involve Vale style fixes (future tense to present tense, punctuation placement). These are typically minor wording adjustments rather than structural content changes. - -The `agent/workflows.mdx` update is a content addition (Slack notification documentation) that requires translation of new material.