Skip to content

Remove release dependency on markdown link check (Rev2)#765

Merged
jaffrepaul merged 1 commit into
cypress-io:masterfrom
MikeMcC399:fix/move-markdown-check
Feb 3, 2023
Merged

Remove release dependency on markdown link check (Rev2)#765
jaffrepaul merged 1 commit into
cypress-io:masterfrom
MikeMcC399:fix/move-markdown-check

Conversation

@MikeMcC399

@MikeMcC399 MikeMcC399 commented Feb 1, 2023

Copy link
Copy Markdown
Collaborator

This PR resolves issue #717 "Bad external links may block release". It is a rework of PR #762.

In .github/workflows/main.yml npm run check:markdown is removed from the build-and-test job and placed inside a new independent workflow .github/workflows/check-markdown.yml.

This means that a release can optionally be carried out independently of a markdown link error. This may be necessary and desired if a link failure is caused by a temporary issue on an external website. If on the other hand there is a hard failure in a markdown hyperlink this should preferably be corrected before a PR is merged for release.

The change in this PR gives the decision-making to the person merging the PR. An automatic block of releasing caused by a bad external website no longer takes place.

Verification

Markdown error case

  1. Introduce a link error into README.md
  2. Execute npm run check:markdown locally and verify the test fails
  3. Manually run the action .github/workflows/check-markdown.yml and confirm it fails.

In a copy of the cypress-io/github-action/ repo:

  1. Simulate a release in the presence of a markdown link error and confirm that it succeeds, despite there being a markdown link error present.

Markdown non-error case

  1. Remove the link error from README.md
  2. Execute npm run check:markdown locally and verify the test succeeds
  3. Manually run the action .github/workflows/check-markdown.yml and confirm it succeeds.

@MikeMcC399

Copy link
Copy Markdown
Collaborator Author

@jaffrepaul

This PR is now ready for review and merge.

The PR does not trigger a release. The final check will occur the next time a release is triggered, however since the change to .github/workflows/main.yml is very minimal (removal of the - run: npm run check:markdown step) I do not anticipate any problem there. I tested in a repo copy where the release went through correctly.

@jaffrepaul jaffrepaul left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Great stuff, thanks @MikeMcC399!

@jaffrepaul jaffrepaul merged commit 3194830 into cypress-io:master Feb 3, 2023
@MikeMcC399 MikeMcC399 deleted the fix/move-markdown-check branch February 3, 2023 16:01
@github-actions

github-actions Bot commented Feb 3, 2023

Copy link
Copy Markdown

🎉 This PR is included in version 5.0.8 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants