Skip to content

Refactor for root-level en translations#42

Merged
cbrinicombe13 merged 1 commit intomainfrom
restructure-translations
Apr 1, 2026
Merged

Refactor for root-level en translations#42
cbrinicombe13 merged 1 commit intomainfrom
restructure-translations

Conversation

@cbrinicombe13
Copy link
Copy Markdown
Member

  • Migrated canonical English docs from en/ into repo-root paths (using git mv) so default-language routes are unprefixed and file history is preserved.
  • Updated docs.json English navigation paths to root-based routes and added legacy redirect support from /en/:slug* to /:slug*.
  • Refactored localization scripts to support root source -> locale target mapping (instead of en/ source assumptions), including link localization, heading-anchor sync, OpenAPI title sync, and translation parity checks.
  • Updated i18n.json bucket includes to match root-source file paths, keeping locale targets under es/ (and future locale dirs).
  • Fixed relative import/media path depth in moved English MDX files so snippets, assets, and components resolve correctly after the directory shift.
  • Updated translation validation workflow path filters to watch root content sections instead of en/**.
  • Revised docs/rules (README.md, .cursor/rules/localization-workflow.mdc) to document root-source architecture and locale directory conventions.
  • Resolved broken-link regressions from anchor drift by fixing stale fragments in EN/ES docs and replacing fragile OpenAPI #parameter-* deep links with stable endpoint links + inline parameter names.
  • Added explicit id attributes for deep-linked accordion entries (mirrored across locales) to keep anchor links stable even when accordion titles are translated.
  • Added a new guardrail script (scripts/validate-link-fragments.mjs) + CI step to block fragile #parameter-* links and enforce specific accordion-anchor safety checks.

…refixes, ensuring consistency across all languages. Updated README and localization workflow to reflect changes in file structure and validation scripts.
@mintlify
Copy link
Copy Markdown

mintlify bot commented Apr 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
trophy 🟢 Ready View Preview Apr 1, 2026, 8:49 AM

@cbrinicombe13 cbrinicombe13 merged commit cee27df into main Apr 1, 2026
4 checks passed
@cbrinicombe13 cbrinicombe13 deleted the restructure-translations branch April 1, 2026 09:08
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.

2 participants