fix(rock5/rock5t): repair broken ./3d-case link in accessories README (#1880)#1897
Merged
Milir-Radxa merged 1 commit intoJul 1, 2026
Conversation
User vectorcrumb reported in radxa-docs#1880 that the link to 'Third-Party 3D-Printed Cases' on /rock5/rock5t/accessories returns 404 on the published docs site. Root cause: in the accessories/README.md that acts as the category index page, Docusaurus resolves the autolink [./3d-case] to /rock5/rock5t/3d-case (parent section URL) instead of /rock5/rock5t/accessories/3d-case (the actual docs route). The target file 3d-case.md lives in the same accessories/ subdirectory, but Docusaurus drops the accessories/ segment when autolinking from a category README. Fix: replace the relative autolink [./3d-case] with the absolute path [/rock5/rock5t/accessories/3d-case], so the link is unambiguous regardless of Docusaurus autolink resolution rules. Scope intentionally limited to rock5t only (the product filed in radxa-docs#1880). Same broken pattern also exists in rock5/rock5b, rock4/rock4d, and cubie/a7a but a broader fix is out of scope for this issue. Chinese and English versions updated together for cross-locale sync. Fixes radxa-docs#1880.
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
2 participants
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.
Summary
Fixes the broken "Third-Party 3D-Printed Cases" link on
/rock5/rock5t/accessoriesreported in #1880.Root cause
In
docs/rock5/rock5t/accessories/README.md(the category index page), Docusaurus resolves the relative autolink[./3d-case]to/rock5/rock5t/3d-case(the parent section URL) instead of/rock5/rock5t/accessories/3d-case(the actual docs route). The target file3d-case.mdlives in the sameaccessories/subdirectory, but Docusaurus drops theaccessories/segment when autolinking from a category README.The user sees a 404 when clicking the link on https://docs.radxa.com/rock5/rock5t/accessories.
Fix
Replace the relative autolink
[./3d-case]with the absolute path[/rock5/rock5t/accessories/3d-case]in both Chinese and English versions, so the link is unambiguous regardless of Docusaurus autolink resolution rules.docs/rock5/rock5t/accessories/README.md[./3d-case][/rock5/rock5t/accessories/3d-case]i18n/en/.../rock5/rock5t/accessories/README.md[./3d-case][/rock5/rock5t/accessories/3d-case]Scope
This PR is intentionally limited to rock5t only (the product named in #1880). The same broken autolink pattern also affects
rock5/rock5b,rock4/rock4d, andcubie/a7a, but those are out of scope here — they are covered separately under PR #41 (broader scope batch fix).Stats
Source
Triggered by user request from internal support group (售后技术支持).