Skip to content

Conversation

estroz
Copy link
Member

@estroz estroz commented May 14, 2020

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.

@openshift-ci-robot openshift-ci-robot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label May 14, 2020
@estroz estroz force-pushed the chore/remove-marker branch 2 times, most recently from 57c5596 to 74797f4 Compare May 14, 2020 22:52
@estroz estroz removed request for fabianvf and joelanford May 14, 2020 22:53
@estroz estroz force-pushed the chore/remove-marker branch 2 times, most recently from 060507f to d69cab3 Compare May 14, 2020 23:03
@estroz estroz marked this pull request as ready for review May 14, 2020 23:03
@openshift-ci-robot openshift-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label May 14, 2020
@estroz estroz requested review from asmacdo, jmrodri and joelanford May 14, 2020 23:41
excludes=$(grep -vxF -f .marker.tmp.changed .marker.tmp.all | sed -e 's/^/--exclude /')
rm .marker.tmp.*

./hack/ci/marker --exclude website $excludes
Copy link
Member

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)

Copy link
Member Author

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.

Copy link
Member

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

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.

Copy link
Member Author

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.

Copy link
Member Author

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.

Copy link
Member

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.

@asmacdo
Copy link
Member

asmacdo commented May 15, 2020

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.

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