-
Notifications
You must be signed in to change notification settings - Fork 8.1k
Use relative markdown links #10615
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Use relative markdown links #10615
Conversation
b1d7ada to
fafe6e6
Compare
|
Deploy preview for docsdocker ready! Built with commit b1d7ada |
|
Deploy preview for docsdocker ready! Built with commit eb94850 |
|
Added some minor comments. @StefanScherer Appreciate an extra pair of eyes for the review as there are quite a lot of URLs that are updated. |
|
Let me see if I can fix that javascript thing. 😞 |
fafe6e6 to
bc79cea
Compare
|
@usha-mandya @StefanScherer I pushed some commits to this PR to remove the "baseHref" from pages, fix links that were generated in the reference docs template, and to fix the JavaScript "link fix"; I also moved that script to only run on the reference pages (which is the only place where we should need it. |
1f0949c to
f641096
Compare
Unfortunately, the only reliable way to create internal links is to use relative links to other Markdown files. This does match the way links on GitHub work, but makes it harder to create these links. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Unfortunately, the only reliable way to create internal links is to use relative links to other Markdown files. This does match the way links on GitHub work, but makes it harder to create these links. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Unfortunately, the only reliable way to create internal links is to use relative links to other Markdown files. This does match the way links on GitHub work, but makes it harder to create these links. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
f641096 to
eb94850
Compare
|
Rebased, now that #10549 was merged; this should be ready for review again (and links should all work now) |
usha-mandya
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you @thaJeztah. The previous issues are all fixed now.
StefanScherer
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
tested a few links and found no issues.
Unfortunately, the only reliable way to create internal links is to use relative links to other Markdown files. This does match the way links on GitHub work, but makes it harder to create these links.
This PR changes most links to use relative paths; for now, I excluded the "enterprise" sections, as those will be migrated to the Mirantis website soon
The reference docs need some more investigating, as it looks like the Markdown inserted from the YAML files are not converted correctly (links are generated includingsee #10549.md); possibly because paths are resolved relative to the include?)