Refactor for root-level en translations#42
Merged
cbrinicombe13 merged 1 commit intomainfrom Apr 1, 2026
Merged
Conversation
Member
cbrinicombe13
commented
Apr 1, 2026
- 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.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
jasontlouro
approved these changes
Apr 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.