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

add markdown link checker #672

Merged
merged 5 commits into from
Nov 30, 2023
Merged

Conversation

nvliyuan
Copy link
Contributor

This PR is to add a markdown link checker to the repo.
We set check-modified-files-only=yes, and we set main as base-branch to specify when finding modified markdown files.
More details please find doc

Signed-off-by: liyuan [email protected]

@nvliyuan
Copy link
Contributor Author

verified it works well and revert the test commit
image

@mattahrens
Copy link
Collaborator

We do development on the dev branch and then only update main branch after we do a release. What is the benefit of using the main branch instead of the dev branch as the base for the markdown check?

with:
max-depth: -1
use-verbose-mode: 'yes'
check-modified-files-only: 'yes'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should it be modified files only or all links? This could potentially not detect dead links in files that are never modified.

@nvliyuan
Copy link
Contributor Author

nvliyuan commented Nov 29, 2023

We do development on the dev branch and then only update main branch after we do a release. What is the benefit of using the main branch instead of the dev branch as the base for the markdown check?

it is also ok to set the base branch to dev.

Should it be modified files only or all links? This could potentially not detect dead links in files that are never modified.

It is a good idea to check all files at the first time, since there is not much files in this repo and it will only take 26s to scan all files.

fix all dead links.

Copy link
Collaborator

@parthosa parthosa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @nvliyuan. This change is really helpful.

Do we know any tool that does similar checking for links present in the codebase (documentation or comments)?

@nvliyuan
Copy link
Contributor Author

@parthosa could you help merge the pr? I cannot merge it due to the permission.

@parthosa
Copy link
Collaborator

parthosa commented Nov 30, 2023

Thanks @nvliyuan

@parthosa parthosa merged commit 3fa1a28 into NVIDIA:dev Nov 30, 2023
9 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