Skip to content
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

doc: fix missing references to README.md #860

Merged
merged 1 commit into from
Sep 24, 2024

Conversation

dbkinder
Copy link
Collaborator

Cross-repo references using an URL that only has the folder name cause links in the github.io site to go to the github.com site. Most of these uses want to link to the documentation (README.md) so add that where appropriate so links in the github.io site stay there.

@dbkinder
Copy link
Collaborator Author

The link check failure to https://github.com/opea-project/docs/tree/main/guide/installation/k8s_install/README.md is because the file being referenced is added by an unmerged PR in the docs repo opea-project/docs#170. I guess we need to merge that one first before this one will succeed?

Perhaps we need a way to override the link check failure if you consider the case where there is a circular failure between PRs in two different repos. We could have the situation where two docs are added in separate repos that link to each other. Both of these PRs would fail the link check and neither could be merged. :(

@lvliang-intel
Copy link
Collaborator

@dbkinder,
please check the readme path issue.

image

@dbkinder
Copy link
Collaborator Author

@dbkinder, please check the readme path issue.

image

Need to have the docs repo opea-project/docs#170 merged before this one will pass your linkcheck and can be merged.

Cross-repo references using an URL that only has the folder name cause
links in the github.io site to go to the github.com site.  Most of these
uses want to link to the documentation (README.md) so add that where
appropriate so links in the github.io site stay there.

Also use an URL when relative links want to take you to the github.com
repo and add the README.md when the document is the link target.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
@dbkinder
Copy link
Collaborator Author

@lvliang-intel Passing checks now... ready for your review/approval/merge

@lvliang-intel lvliang-intel merged commit 3e796ba into opea-project:main Sep 24, 2024
7 checks passed
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