-
Notifications
You must be signed in to change notification settings - Fork 1.8k
*: remove marker in favor of Github action #3048
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
Conversation
57c5596
to
74797f4
Compare
060507f
to
d69cab3
Compare
excludes=$(grep -vxF -f .marker.tmp.changed .marker.tmp.all | sed -e 's/^/--exclude /') | ||
rm .marker.tmp.* | ||
|
||
./hack/ci/marker --exclude website $excludes |
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.
With marker, we had to exclude files in the website directory (the links are built by hugo and I don't think they will work.)
IMO this should be blocked until gaurav-nelson/github-action-markdown-link-check#38 is implemented. (Or we could whitelist files to check)
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.
The config directs this checker to only check links in top-level files (max-depth: 1
), so it ignores anything in website
.
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.
If this will no longer check design, proposals, thats fine with me since those need to be moved anyway.
@@ -0,0 +1,6 @@ | |||
{ |
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.
For this to be a drop in replacement, we need to only check changed files with check-modified-files-only
option.
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.
We only wrote that functionality into the markdown checker because it was breaking on certain sites, and we knew the file it was breaking on wasn’t modified often. I think it’s safe to check all top-level files again.
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.
Also we need to check all links on each PR because a linked file could be moved, breaking links in unmodified docs.
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.
Cool, since we will be checking many fewer links, hopefully we won't get the 429s from github.
Lets keep a close eye on whether this can be a blocking check. For example, if we added a page to the website and a link to it in the README, the link target won't exist until after the PR merges. |
Description of the change: use Github action link checker instead of
marker
.Motivation for the change: use a more widely supported tool for markdown link checking, and use Github actions as to not block PR's if links break. We can make the link check required later.