Skip to content

Translate relative link resolution documentation#5521

Merged
mintlify[bot] merged 1 commit intomainfrom
mintlify/translate-linking-relative-paths-1777053369
Apr 24, 2026
Merged

Translate relative link resolution documentation#5521
mintlify[bot] merged 1 commit intomainfrom
mintlify/translate-linking-relative-paths-1777053369

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 24, 2026

Summary

Translates the relative link resolution documentation added in #5384 into Spanish, French, and Chinese.

Updates es/guides/linking.mdx, fr/guides/linking.mdx, and zh/guides/linking.mdx to include:

  • New section explaining how Mintlify resolves ./ and ../ paths based on source file location
  • Example code blocks for sibling and parent relative paths
  • Explanation of index.mdx path resolution
  • New Tip callout recommending root-relative paths
  • Updated FAQ accordion reflecting that root-relative paths are the most common (rather than "correct") choice, with a note about when relative paths may break

Note

Low Risk
Documentation-only updates localized into es, fr, and zh; no runtime/code-path changes, with low risk limited to wording/translation accuracy.

Overview
Adds translated guidance in Spanish, French, and Chinese guides/linking.mdx describing how Mintlify resolves ./ and ../ relative paths (including index.mdx behavior) and that fragments/query strings are preserved.

Updates the internal-link FAQ wording to frame root-relative paths as the most common choice and adds a caution that source-location-based relative links can break more often, plus a new Tip recommending root-relative internal links.

Reviewed by Cursor Bugbot for commit 90f246b. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify mintlify Bot merged commit 98b212e into main Apr 24, 2026
2 checks passed
@mintlify-development
Copy link
Copy Markdown
Contributor

mintlify-development Bot commented Apr 24, 2026

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

Project Status Preview Updated (UTC)
userauth 🔴 Failed Apr 24, 2026, 6:00 PM

@mintlify mintlify Bot deleted the mintlify/translate-linking-relative-paths-1777053369 branch April 24, 2026 17:57
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 24, 2026

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

Project Status Preview Updated (UTC)
mintlify 🔴 Failed Apr 24, 2026, 5:59 PM

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.

0 participants