ci: replace unmaintained markdown link checker (#15424)

ethanndickson · web-flow · commit 6e18742ad36a · 2024-11-07T22:30:43.000+11:00
The old one was flaking a bunch and blocking PRs. This is the one
recommended by the maintainer of the old.
diff --git a/.github/.linkspector.yml b/.github/.linkspector.yml
@@ -0,0 +1,9 @@
+dirs:
+  - docs
+ignorePatterns:
+  - pattern: "://localhost"
+  - pattern: '://.*.?example\\.com'
+  - pattern: "github.com/<your_github_handle>"
+  - pattern: "mailto:"
+aliveStatusCodes:
+  - 200
diff --git a/.github/workflows/mlc_config.json b/.github/workflows/mlc_config.json
diff --git a/.github/workflows/weekly-docs.yaml b/.github/workflows/weekly-docs.yaml
@@ -26,15 +26,13 @@ jobs:
         uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4.2.1
 
       - name: Check Markdown links
-        uses: gaurav-nelson/github-action-markdown-link-check@d53a906aa6b22b8979d33bc86170567e619495ec # v1.0.15
+        uses: umbrelladocs/action-linkspector@fc382e19892aca958e189954912fe379a8df270c # v1.2.4
         id: markdown-link-check
         # checks all markdown files from /docs including all subfolders
         with:
-          use-quiet-mode: "yes"
-          use-verbose-mode: "yes"
-          config-file: ".github/workflows/mlc_config.json"
-          folder-path: "docs/"
-          file-path: "./README.md"
+          reporter: github-pr-review
+          config_file: ".github/.linkspector.yml"
+          fail_on_error: "true"
 
       - name: Send Slack notification
         if: failure() && github.event_name == 'schedule'
diff --git a/docs/admin/integrations/jfrog-xray.md b/docs/admin/integrations/jfrog-xray.md
@@ -27,7 +27,7 @@ using Coder's [JFrog Xray Integration](https://github.com/coder/coder-xray).
    [permission](https://jfrog.com/help/r/jfrog-platform-administration-documentation/permissions)
    for the repositories you want to scan.
 1. Create a Coder [token](../../reference/cli/tokens_create.md#tokens-create)
-   with a user that has the [`owner`](../users#roles) role.
+   with a user that has the [`owner`](../users/index.md#roles) role.
 1. Create Kubernetes secrets for the JFrog Xray and Coder tokens.
 
    ```bash
