Skip to content

Make check:markdown successful for github domain checks#667

Merged
jaffrepaul merged 2 commits into
cypress-io:masterfrom
MikeMcC399:fix/check-markdown
Dec 14, 2022
Merged

Make check:markdown successful for github domain checks#667
jaffrepaul merged 2 commits into
cypress-io:masterfrom
MikeMcC399:fix/check-markdown

Conversation

@MikeMcC399

Copy link
Copy Markdown
Collaborator

This PR resolves issue #664 "markdown-link-check produces wrong results and exit status"

  1. To resolve the issue that link checking on the domain github.com results in 403 Forbidden errors, the new markdown-link-check configuration file md-linkcheck.json is added and it is referred to by the script check:markdown. After adding this config file, checks on links to github.com no longer produce a 403 error.

  2. To resolve the issue that the action main.yml is successful, even when the markdown link check fails, the check:markdown script is converted to use xargs instead of exec as suggested in https://github.com/tcort/markdown-link-check#check-links-from-a-local-markdown-folder-recursive.

The new check:markdown script, which is invoked by npm run check:markdown is now defined as:

find *.md -print0 | xargs -0 -n1 markdown-link-check -c md-linkcheck.json

Changing the script ensures that no 403 (forbidden) errors are produced for otherwise correctly working links on github.com. Also if there are genuine link errors found, then the main.yml action will show failure, which should alert to one or more links which need correcting. In the past, link check failures went (apparently) unnoticed.

Verification

Verification with bad links

When there are known bad links in *.md files e.g. when npm run check:markdown finds 400 or 404 errors for links on the branch to be tested.

After main.yml has completed its run, examine the logs.

"Test on Node v14" has a red X. "Run npm run check:markdown" shows no 403 errors and completes with the message "Error: Process completed with exit code 123."

link failure no 403

Verification with no bad links

When there are no known bad links in *.md files e.g. when npm run check:markdown finds no 400 or 404 errors for links on the branch to be tested.

After main.yml has completed its run, examine the logs of main.yml.

Look for success (green tick).

Matrix build-and-test shows 3 jobs completed.

main matrix

Look at details of any of Test on Node v14 / v16 / v18. Drill down into "Run npm run check:markdown" which should end with no errors and a line similar to "134 links checked."

links checked

@MikeMcC399

This comment was marked as outdated.

@MikeMcC399

This comment was marked as outdated.

run check:markdown reports back failure status if bad links are found
@MikeMcC399

Copy link
Copy Markdown
Collaborator Author

run 3688072982 was successful

image

There were no link check errors recorded. No more 403 errors (forbidden). The 400 and 404 errors were already removed by PR #665

image

This PR is now ready for review and merge.

@jaffrepaul jaffrepaul merged commit 14e17a5 into cypress-io:master Dec 14, 2022
@MikeMcC399 MikeMcC399 deleted the fix/check-markdown branch December 14, 2022 20:19
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 5.0.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

kodiakhq Bot referenced this pull request in weareinreach/InReach Dec 20, 2022
[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [actions/checkout](https://togithub.com/actions/checkout) | action | digest | `7dd9e2a` -> `755da8c` |
| [chromaui/action](https://togithub.com/chromaui/action) | action | digest | `0ec8cd8` -> `2440d35` |
| [cypress-io/github-action](https://togithub.com/cypress-io/github-action) | action | patch | `v5.0.0` -> `v5.0.2` |
| [github/codeql-action](https://togithub.com/github/codeql-action) | action | digest | `a669cc5` -> `959cbb7` |
| [tinkurlab/monorepo-pr-labeler-action](https://togithub.com/tinkurlab/monorepo-pr-labeler-action) | action | patch | `4.1.2` -> `4.1.3` |

---

### Release Notes

<details>
<summary>cypress-io/github-action</summary>

### [`v5.0.2`](https://togithub.com/cypress-io/github-action/releases/tag/v5.0.2)

[Compare Source](https://togithub.com/cypress-io/github-action/compare/v5.0.1...v5.0.2)

Numerous housekeeping updates to bring this action back up to speed.

\*In combination with v5.0.1, which triggered without a new dist build.

👏 Special thanks to [@&#8203;MikeMcC399](https://togithub.com/MikeMcC399) for all the diligent work! 👏

**Fix Failed Tests**

-   [https://github.com/cypress-io/github-action/pull/643](https://togithub.com/cypress-io/github-action/pull/643)
-   [https://github.com/cypress-io/github-action/pull/658](https://togithub.com/cypress-io/github-action/pull/658)
-   [https://github.com/cypress-io/github-action/pull/660](https://togithub.com/cypress-io/github-action/pull/660)

**Update Dependencies**

-   [https://github.com/cypress-io/github-action/pull/644](https://togithub.com/cypress-io/github-action/pull/644)
-   [https://github.com/cypress-io/github-action/pull/650](https://togithub.com/cypress-io/github-action/pull/650)

**Resolve Warnings**

-   [https://github.com/cypress-io/github-action/pull/651](https://togithub.com/cypress-io/github-action/pull/651)
-   [https://github.com/cypress-io/github-action/pull/666](https://togithub.com/cypress-io/github-action/pull/666)
-   [https://github.com/cypress-io/github-action/pull/670](https://togithub.com/cypress-io/github-action/pull/670)
-   [https://github.com/cypress-io/github-action/pull/675](https://togithub.com/cypress-io/github-action/pull/675)

**Docs/Example Updates**

-   [https://github.com/cypress-io/github-action/pull/665](https://togithub.com/cypress-io/github-action/pull/665)
-   [https://github.com/cypress-io/github-action/pull/668](https://togithub.com/cypress-io/github-action/pull/668)

**Tooling Updates:**

-   [https://github.com/cypress-io/github-action/pull/667](https://togithub.com/cypress-io/github-action/pull/667)
-   [https://github.com/cypress-io/github-action/pull/677](https://togithub.com/cypress-io/github-action/pull/677)

### [`v5.0.1`](https://togithub.com/cypress-io/github-action/releases/tag/v5.0.1)

[Compare Source](https://togithub.com/cypress-io/github-action/compare/v5.0.0...v5.0.1)

##### Bug Fixes

-   correct .gitignore for videos and screenshots ([89e59e5](https://togithub.com/cypress-io/github-action/commit/89e59e5cfc7760513fe9e9ce4c690345d94eb27a))

</details>

<details>
<summary>tinkurlab/monorepo-pr-labeler-action</summary>

### [`v4.1.3`](https://togithub.com/TinkurLab/monorepo-pr-labeler-action/releases/tag/4.1.3): Monorepo PR Labeler v4.1.3

[Compare Source](https://togithub.com/tinkurlab/monorepo-pr-labeler-action/compare/4.1.2...4.1.3)

Changes include:

Bug fix to ignore directories starting with a dot `.` but not directories that contain a dot `.`. According to the docs, this action should ignore mono repos that begin with a dot but it currently ignores also mono repo with a dot even if it is not the first character. Thanks to [@&#8203;MoLow](https://togithub.com/MoLow) for the fix!

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://togithub.com/renovatebot/renovate/discussions) if that's undesired.

---

 - [ ] If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://app.renovatebot.com/dashboard#github/weareinreach/InReach).



PR-URL: #107
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants