Skip to content

Conversation

@thaJeztah
Copy link
Member

@thaJeztah thaJeztah commented Apr 10, 2020

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 including .md); possibly because paths are resolved relative to the include?) see #10549

@netlify
Copy link

netlify bot commented Apr 10, 2020

Deploy preview for docsdocker ready!

Built with commit b1d7ada

https://deploy-preview-10615--docsdocker.netlify.com

@netlify
Copy link

netlify bot commented Apr 10, 2020

Deploy preview for docsdocker ready!

Built with commit eb94850

https://deploy-preview-10615--docsdocker.netlify.app

@usha-mandya usha-mandya self-requested a review April 15, 2020 09:53
@usha-mandya
Copy link
Member

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.

@thaJeztah
Copy link
Member Author

Let me see if I can fix that javascript thing. 😞

@thaJeztah
Copy link
Member Author

@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.

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>
@thaJeztah
Copy link
Member Author

Rebased, now that #10549 was merged; this should be ready for review again (and links should all work now)

Copy link
Member

@usha-mandya usha-mandya left a 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.

Copy link
Member

@StefanScherer StefanScherer left a 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.

@usha-mandya usha-mandya merged commit 53ca727 into docker:master Apr 23, 2020
@thaJeztah thaJeztah deleted the relative_links branch April 23, 2020 15:46
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.

3 participants