ci: add link checks to the docs (#1971)

* ci: add link checks to the docs

* updated regex

* stop 403s from discord support links

.github/workflows/docs-link-check.yml

@@ -0,0 +1,74 @@
+---
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+name: Check Docs Links
+
+on:
+    pull_request:
+        branches:
+            - '*'
+        paths:
+            - 'docs/**'
+            - 'gen-docs/**'
+            - '.github/workflows/docs-link-check.yml'
+    push:
+        branches:
+            - develop
+        paths:
+            - 'docs/**'
+            - 'gen-docs/**'
+            - '.github/workflows/docs-link-check.yml'
+    schedule:
+        - cron: '50 7 * * 5'
+    workflow_dispatch:
+
+permissions:
+    contents: read
+
+concurrency:
+    group: docs-link-check-${{ github.ref }}
+    cancel-in-progress: true
+
+jobs:
+    link-check:
+        name: Verify external links in Markdown and MDX
+        runs-on: ubuntu-24.04
+        timeout-minutes: 20
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+                  persist-credentials: false
+
+            - name: Run Lychee link checker
+              uses: lycheeverse/lychee-action@v2
+              with:
+                  fail: false
+                  args: >-
+                      --verbose
+                      --no-progress
+                      --accept 200..204,300..304,307,308,404,429,999
+                      --include '^(http|https)://.*'
+                      --exclude '^file://'
+                      --exclude '^https?://localhost'
+                      --exclude '^https?://127\.0\.0\.1'
+                      --exclude '^https?://0\.0\.0\.0'
+                      --exclude '^https?://\[\:\:1\]'
+                      --exclude '^https?://\[\:\:\]'
+                      --exclude '^https?://support.discord.com'
+                      './docs/**/*.md'
+                      './docs/**/*.mdx'
+                      './gen-docs/**/*.md'
+                      './gen-docs/**/*.mdx'
+              env:
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+            - name: Upload Lychee report
+              uses: actions/upload-artifact@v4
+              with:
+                  name: lychee-report
+                  path: |
+                      lychee/out.md
+                      lychee/results.json
+                  if-no-files-found: ignore