Conversation
Relative links like ../deploy/portability.md only resolve next to the page they are on, so they break the build as soon as one end is translated and the other is not. Paths from the docs root resolve in the translated folder first and fall back to the English one.
lmac-1
changed the title
lmac-1
force-pushed
the
absolute-links
branch
from
September 25, 2026 15:03
d4c2d47 to
fd61e31
Compare
This was referenced Sep 25, 2026
This branch has not been deployed
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
1 participant
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.
Short Description
Replaces relative links in
docs/(like../deploy/portability.md) with file paths from the docs root (like/deploy/portability.md), to prepare the docs for translation. Relative links break the build as soon as one end is translated and the other isn't; docs-root paths work either way and are still the file links Docusaurus recommends.Closes #867
Details
A script rewrote 111 links in 35 files. Only link targets changed, each on its original line. The second commit updates the house style in
AGENTS.mdand the translate skill to match, so agents stop writing relative links and the translate skill no longer rewrites them.Worth checking:
migration/converting-triggers.mdintoversioned_docs/can't be file links, so they go to/documentation/legacy/build/triggers.manage-projects/oauth.mdare now/adaptors/...URLs, since file links only work withindocs/./as the repo root, so these links don't work when clicking through Markdown on GitHub. The site isn't affected.Merge order: this overlaps with the Prettier PR #875, which reformats many of the same files. Merge this one first; #875 gets re-run afterwards rather than having its conflicts fixed by hand.
AI Usage
Please disclose how you've used AI in this work (it's cool, we just want to know!):
You can read more details in our Responsible AI Policy