From b886e148adcb2ae699d742ead61f1d72075e7245 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Wed, 15 Oct 2025 10:08:43 -0700
Subject: [PATCH 01/53] added workflow

---
 .github/workflows/lychee.yml | 42 ++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 .github/workflows/lychee.yml

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
new file mode 100644
index 0000000000..6c87f778a7
--- /dev/null
+++ b/.github/workflows/lychee.yml
@@ -0,0 +1,42 @@
+name: Lychee Link Checker
+on: [pull_request]
+
+jobs:
+  linkChecker:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Link Checker
+        id: lychee
+        uses: lycheeverse/lychee-action@v2
+        with:
+          fail: true
+
+      - name: Create Issue From File
+        if: steps.lychee.outputs.exit_code != 0
+        uses: peter-evans/create-issue-from-file@v5
+        with:
+          title: Link Checker Report
+          content-filepath: ./lychee/out.md
+          labels: report, automated issue
+# name: Linkspector
+# on: [pull_request]
+# jobs:
+#   check-links:
+#     name: runner / linkspector
+#     runs-on: ubuntu-22.04
+#     permissions:
+#       contents: write
+#     steps:
+#       - uses: actions/checkout@v4
+#       - name: Run linkspector
+#         uses: umbrelladocs/action-linkspector@v1.3.7
+#         with:
+#           github_token: ${{ secrets.github_token }}
+#           reporter: github-pr-check
+#           fail_on_error: true
+#           filter_mode: nofilter
+#           config_file: .github/workflows/config/.linkspector.yml

From a521a4be969b49de5372993ef11dd2e973d8529e Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Wed, 15 Oct 2025 10:13:34 -0700
Subject: [PATCH 02/53] lychee checker updated

---
 .github/workflows/lychee.yml | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 6c87f778a7..41cbc808b6 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -1,25 +1,26 @@
-name: Lychee Link Checker
+name: Lychee
 on: [pull_request]
 
 jobs:
-  linkChecker:
+  lychee:
     runs-on: ubuntu-latest
     permissions:
       issues: write
     steps:
       - uses: actions/checkout@v4
 
-      - name: Link Checker
+      - name: Lychee Link Checker
         id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
           fail: true
+          workingDirectory: "."
 
       - name: Create Issue From File
         if: steps.lychee.outputs.exit_code != 0
         uses: peter-evans/create-issue-from-file@v5
         with:
-          title: Link Checker Report
+          title: Lychee Report
           content-filepath: ./lychee/out.md
           labels: report, automated issue
 # name: Linkspector

From d1c5be6fb2d00f2ac9a7ba7326d6fb2473f0f81c Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Wed, 15 Oct 2025 10:17:56 -0700
Subject: [PATCH 03/53] update link again

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 41cbc808b6..3d9a8486db 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -14,7 +14,7 @@ jobs:
         uses: lycheeverse/lychee-action@v2
         with:
           fail: true
-          workingDirectory: "."
+          workingDirectory: "../../"
 
       - name: Create Issue From File
         if: steps.lychee.outputs.exit_code != 0

From c73c151668f8c0ea4ec1d835ab0ce1fbb288e7d7 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 14:22:04 -0400
Subject: [PATCH 04/53] lychee updated

---
 .github/workflows/lychee.yml | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 3d9a8486db..075a1e7888 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -1,28 +1,27 @@
 name: Lychee
+
 on: [pull_request]
 
 jobs:
-  lychee:
+  linkChecker:
     runs-on: ubuntu-latest
     permissions:
-      issues: write
+      issues: write # Required for peter-evans/create-issue-from-file
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
+
+      - name: Build site
+        uses: withastro/action@v4
+        with:
+          package-manager: pnpm@latest
 
       - name: Lychee Link Checker
         id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
-          fail: true
-          workingDirectory: "../../"
+          args: --base-url dist --exclude-all-private dist
+          fail: false
 
-      - name: Create Issue From File
-        if: steps.lychee.outputs.exit_code != 0
-        uses: peter-evans/create-issue-from-file@v5
-        with:
-          title: Lychee Report
-          content-filepath: ./lychee/out.md
-          labels: report, automated issue
 # name: Linkspector
 # on: [pull_request]
 # jobs:

From 641f1ea8f3614236f26cbd63b612d15acd63993b Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 14:27:48 -0400
Subject: [PATCH 05/53] revert back

---
 .github/workflows/lychee.yml | 47 ++++++++++++++++++++++++++++--------
 1 file changed, 37 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 075a1e7888..bd540bdd65 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -3,24 +3,51 @@ name: Lychee
 on: [pull_request]
 
 jobs:
-  linkChecker:
+  lychee:
     runs-on: ubuntu-latest
     permissions:
-      issues: write # Required for peter-evans/create-issue-from-file
+      issues: write
     steps:
-      - uses: actions/checkout@v5
-
-      - name: Build site
-        uses: withastro/action@v4
-        with:
-          package-manager: pnpm@latest
+      - uses: actions/checkout@v4
 
       - name: Lychee Link Checker
         id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
-          args: --base-url dist --exclude-all-private dist
-          fail: false
+          fail: true
+          workingDirectory: "../../"
+
+      - name: Create Issue From File
+        if: steps.lychee.outputs.exit_code != 0
+        uses: peter-evans/create-issue-from-file@v5
+        with:
+          title: Lychee Report
+          content-filepath: ./lychee/out.md
+          labels: report, automated issue
+
+# name: Lychee
+
+# on: [pull_request]
+
+# jobs:
+#   linkChecker:
+#     runs-on: ubuntu-latest
+#     permissions:
+#       issues: write # Required for peter-evans/create-issue-from-file
+#     steps:
+#       - uses: actions/checkout@v5
+
+#       - name: Build site
+#         uses: withastro/action@v4
+#         with:
+#           package-manager: pnpm@latest
+
+#       - name: Lychee Link Checker
+#         id: lychee
+#         uses: lycheeverse/lychee-action@v2
+#         with:
+#           args: --base-url dist --exclude-all-private dist
+#           fail: false
 
 # name: Linkspector
 # on: [pull_request]

From 690121c2940c2a343f476231fee2b5ed2f2978e1 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 14:29:07 -0400
Subject: [PATCH 06/53] edit fail conditions

---
 .github/workflows/lychee.yml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index bd540bdd65..33a23ddb35 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -14,7 +14,7 @@ jobs:
         id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
-          fail: true
+          fail: false
           workingDirectory: "../../"
 
       - name: Create Issue From File
@@ -25,6 +25,12 @@ jobs:
           content-filepath: ./lychee/out.md
           labels: report, automated issue
 
+      - name: Fail if broken links found
+        if: steps.lychee.outputs.exit_code != 0
+        run: |
+          echo "Broken links found. See issue created above for details."
+          exit 1
+
 # name: Lychee
 
 # on: [pull_request]

From 5702af9452cc2af7fed08224115308a79284c50e Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:14:54 -0400
Subject: [PATCH 07/53] check 2

---
 .github/workflows/lychee.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 33a23ddb35..396e8ad9b5 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -15,7 +15,6 @@ jobs:
         uses: lycheeverse/lychee-action@v2
         with:
           fail: false
-          workingDirectory: "../../"
 
       - name: Create Issue From File
         if: steps.lychee.outputs.exit_code != 0

From d54b4b3816e4ef67cc6655984d36a9185d636676 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:22:35 -0400
Subject: [PATCH 08/53] lychee changed

---
 .github/workflows/lychee.yml | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 396e8ad9b5..05b911ccad 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -11,25 +11,17 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Lychee Link Checker
-        id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
-          fail: false
+          fail: true
 
       - name: Create Issue From File
         if: steps.lychee.outputs.exit_code != 0
         uses: peter-evans/create-issue-from-file@v5
         with:
-          title: Lychee Report
+          title: Link Checker Report
           content-filepath: ./lychee/out.md
           labels: report, automated issue
-
-      - name: Fail if broken links found
-        if: steps.lychee.outputs.exit_code != 0
-        run: |
-          echo "Broken links found. See issue created above for details."
-          exit 1
-
 # name: Lychee
 
 # on: [pull_request]

From 3f3f88dacb336b15f8ec770add4a17092a7ce82c Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:24:03 -0400
Subject: [PATCH 09/53] workign dir

---
 .github/workflows/lychee.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 05b911ccad..7da80029c5 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -13,6 +13,7 @@ jobs:
       - name: Lychee Link Checker
         uses: lycheeverse/lychee-action@v2
         with:
+          workingDirectory: "~"
           fail: true
 
       - name: Create Issue From File

From 44e8a7af825a5ecc24355461e85ce9e87ccb6d09 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:26:15 -0400
Subject: [PATCH 10/53] args updated

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 7da80029c5..bd74e8ba31 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -13,7 +13,7 @@ jobs:
       - name: Lychee Link Checker
         uses: lycheeverse/lychee-action@v2
         with:
-          workingDirectory: "~"
+          args: --verbose --no-progress './**/*.md' './**/*.mdx' './**/*.html'
           fail: true
 
       - name: Create Issue From File

From 1907e61f5239fdcf8f7b71e9ccb3ba9ebbcc5398 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:29:49 -0400
Subject: [PATCH 11/53] added comment

---
 .github/workflows/lychee.yml | 53 +++---------------------------------
 1 file changed, 4 insertions(+), 49 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index bd74e8ba31..d64b4e9d19 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -6,7 +6,7 @@ jobs:
   lychee:
     runs-on: ubuntu-latest
     permissions:
-      issues: write
+      pull-requests: write
     steps:
       - uses: actions/checkout@v4
 
@@ -16,52 +16,7 @@ jobs:
           args: --verbose --no-progress './**/*.md' './**/*.mdx' './**/*.html'
           fail: true
 
-      - name: Create Issue From File
-        if: steps.lychee.outputs.exit_code != 0
-        uses: peter-evans/create-issue-from-file@v5
+      - name: Comment Broken Links
+        uses: marocchino/sticky-pull-request-comment@v2
         with:
-          title: Link Checker Report
-          content-filepath: ./lychee/out.md
-          labels: report, automated issue
-# name: Lychee
-
-# on: [pull_request]
-
-# jobs:
-#   linkChecker:
-#     runs-on: ubuntu-latest
-#     permissions:
-#       issues: write # Required for peter-evans/create-issue-from-file
-#     steps:
-#       - uses: actions/checkout@v5
-
-#       - name: Build site
-#         uses: withastro/action@v4
-#         with:
-#           package-manager: pnpm@latest
-
-#       - name: Lychee Link Checker
-#         id: lychee
-#         uses: lycheeverse/lychee-action@v2
-#         with:
-#           args: --base-url dist --exclude-all-private dist
-#           fail: false
-
-# name: Linkspector
-# on: [pull_request]
-# jobs:
-#   check-links:
-#     name: runner / linkspector
-#     runs-on: ubuntu-22.04
-#     permissions:
-#       contents: write
-#     steps:
-#       - uses: actions/checkout@v4
-#       - name: Run linkspector
-#         uses: umbrelladocs/action-linkspector@v1.3.7
-#         with:
-#           github_token: ${{ secrets.github_token }}
-#           reporter: github-pr-check
-#           fail_on_error: true
-#           filter_mode: nofilter
-#           config_file: .github/workflows/config/.linkspector.yml
+          path: lychee/out.md

From 8a356facd273563be39192f33fd856f7f8c0ec6f Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:42:04 -0400
Subject: [PATCH 12/53] lychee tol added

---
 .github/workflows/lychee.yml |  4 ++-
 .lychee.toml                 | 52 ++++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 1 deletion(-)
 create mode 100644 .lychee.toml

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index d64b4e9d19..28db10757f 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -13,8 +13,10 @@ jobs:
       - name: Lychee Link Checker
         uses: lycheeverse/lychee-action@v2
         with:
-          args: --verbose --no-progress './**/*.md' './**/*.mdx' './**/*.html'
+          args: --verbose --no-progress'
           fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.github_token }}
 
       - name: Comment Broken Links
         uses: marocchino/sticky-pull-request-comment@v2
diff --git a/.lychee.toml b/.lychee.toml
new file mode 100644
index 0000000000..b5ded4121a
--- /dev/null
+++ b/.lychee.toml
@@ -0,0 +1,52 @@
+# Accepted status codes - aligned with linkspector config
+accept = [200, 201, 204, 304, 403, 429]
+
+# Cache results to speed up subsequent runs
+cache = true
+
+# Maximum number of retries per link
+max_retries = 3
+
+# Timeout per request in seconds
+timeout = 20
+
+# Maximum number of concurrent network requests
+max_concurrency = 16
+
+# Exclude localhost and local URLs
+exclude = [
+    # Localhost URLs from examples
+    "http://localhost.*",
+    "https://localhost.*",
+    
+    # Relative paths (checked by build process)
+    "^/.*",
+    
+    # MySQL documentation (returns 403 for automated requests)
+    "https://dev.mysql.com/.*",
+    "https://www.mysql.com/.*",
+    
+    # NPM packages (returns 403 for automated requests)
+    "https://www.npmjs.com/.*",
+    
+    # OpenAI platform (returns 403 for automated requests)
+    "https://openai.com/.*",
+    "https://platform.openai.com/.*",
+    
+    # Cloudflare (returns 403 for automated requests)
+    "https://dash.cloudflare.com/.*",
+    "https://playground.ai.cloudflare.com/.*",
+    
+    # CockroachDB blog (certificate issues in CI)
+    "https://www.cockroachlabs.com/blog/.*",
+]
+
+# Exclude email addresses
+exclude_mail = true
+
+# Include files with these extensions
+include = ["**/*.md", "**/*.mdx", "**/*.html"]
+
+# Use custom headers to avoid bot detection
+[headers]
+"User-Agent" = "Mozilla/5.0 (compatible; Link Checker/1.0)"
\ No newline at end of file

From 1d4809b134d449b0fa3fc365fde0aa36e6d93656 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:43:58 -0400
Subject: [PATCH 13/53] edited toml

---
 .lychee.toml | 35 ++---------------------------------
 1 file changed, 2 insertions(+), 33 deletions(-)

diff --git a/.lychee.toml b/.lychee.toml
index b5ded4121a..2b66681214 100644
--- a/.lychee.toml
+++ b/.lychee.toml
@@ -1,52 +1,21 @@
-# Accepted status codes - aligned with linkspector config
 accept = [200, 201, 204, 304, 403, 429]
-
-# Cache results to speed up subsequent runs
 cache = true
-
-# Maximum number of retries per link
 max_retries = 3
-
-# Timeout per request in seconds
 timeout = 20
-
-# Maximum number of concurrent network requests
 max_concurrency = 16
-
-# Exclude localhost and local URLs
 exclude = [
-    # Localhost URLs from examples
     "http://localhost.*",
     "https://localhost.*",
-    
-    # Relative paths (checked by build process)
     "^/.*",
     
-    # MySQL documentation (returns 403 for automated requests)
+    # Third party services that return 403 for automated requests
     "https://dev.mysql.com/.*",
     "https://www.mysql.com/.*",
-    
-    # NPM packages (returns 403 for automated requests)
     "https://www.npmjs.com/.*",
-    
-    # OpenAI platform (returns 403 for automated requests)
     "https://openai.com/.*",
     "https://platform.openai.com/.*",
-    
-    # Cloudflare (returns 403 for automated requests)
     "https://dash.cloudflare.com/.*",
     "https://playground.ai.cloudflare.com/.*",
-    
-    # CockroachDB blog (certificate issues in CI)
     "https://www.cockroachlabs.com/blog/.*",
 ]
-
-# Exclude email addresses
-exclude_mail = true
-
-# Include files with these extensions
-include = ["**/*.md", "**/*.mdx", "**/*.html"]
-
-# Use custom headers to avoid bot detection
-[headers]
-"User-Agent" = "Mozilla/5.0 (compatible; Link Checker/1.0)"
\ No newline at end of file
+include = ["**/*.md", "**/*.mdx", "**/*.html"]
\ No newline at end of file

From 13089c3911941c2f823a088398be5df02a9a64e2 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:45:54 -0400
Subject: [PATCH 14/53] typo fixed

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 28db10757f..2857f29c39 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -13,7 +13,7 @@ jobs:
       - name: Lychee Link Checker
         uses: lycheeverse/lychee-action@v2
         with:
-          args: --verbose --no-progress'
+          args: "--verbose --no-progress"
           fail: true
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}

From b42d699ad410ea0c0d46f3098ff8214c5e3f696c Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:47:53 -0400
Subject: [PATCH 15/53] typos

---
 .github/workflows/lychee.yml | 2 +-
 .lychee.toml => lychee.toml  | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename .lychee.toml => lychee.toml (100%)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 2857f29c39..ab72c53d09 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -13,7 +13,7 @@ jobs:
       - name: Lychee Link Checker
         uses: lycheeverse/lychee-action@v2
         with:
-          args: "--verbose --no-progress"
+          args: --verbose --no-progress
           fail: true
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
diff --git a/.lychee.toml b/lychee.toml
similarity index 100%
rename from .lychee.toml
rename to lychee.toml

From fc4ed54cdcc973623484fa32cb3db42d0960af9e Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 15:49:09 -0400
Subject: [PATCH 16/53] args renoved

---
 .github/workflows/lychee.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index ab72c53d09..81ae65bb10 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -13,7 +13,6 @@ jobs:
       - name: Lychee Link Checker
         uses: lycheeverse/lychee-action@v2
         with:
-          args: --verbose --no-progress
           fail: true
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}

From feb4d8bd0611eac16282868c08220df7874007aa Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:04:38 -0400
Subject: [PATCH 17/53] removed include

---
 lychee.toml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lychee.toml b/lychee.toml
index 2b66681214..93a724e65b 100644
--- a/lychee.toml
+++ b/lychee.toml
@@ -17,5 +17,4 @@ exclude = [
     "https://dash.cloudflare.com/.*",
     "https://playground.ai.cloudflare.com/.*",
     "https://www.cockroachlabs.com/blog/.*",
-]
-include = ["**/*.md", "**/*.mdx", "**/*.html"]
\ No newline at end of file
+]
\ No newline at end of file

From fb93839b67933db0f4f2b7fc53d83f967de647ce Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:05:54 -0400
Subject: [PATCH 18/53] added extensions

---
 lychee.toml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lychee.toml b/lychee.toml
index 93a724e65b..0457e29e77 100644
--- a/lychee.toml
+++ b/lychee.toml
@@ -17,4 +17,5 @@ exclude = [
     "https://dash.cloudflare.com/.*",
     "https://playground.ai.cloudflare.com/.*",
     "https://www.cockroachlabs.com/blog/.*",
-]
\ No newline at end of file
+]
+fallback_extensions = ["md", "mdx", "html"]
\ No newline at end of file

From db95bf9e790e8f00fef1436857ddb1b007ca2937 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:07:57 -0400
Subject: [PATCH 19/53] minor updates

---
 .github/workflows/lychee.yml | 2 ++
 lychee.toml                  | 3 +--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 81ae65bb10..61c5adeb1f 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -14,6 +14,8 @@ jobs:
         uses: lycheeverse/lychee-action@v2
         with:
           fail: true
+          args: --verbose --no-progress './**/*.md' './**/*.mdx' './**/*.html'
+          workingDirectory: "/content"
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
diff --git a/lychee.toml b/lychee.toml
index 0457e29e77..93a724e65b 100644
--- a/lychee.toml
+++ b/lychee.toml
@@ -17,5 +17,4 @@ exclude = [
     "https://dash.cloudflare.com/.*",
     "https://playground.ai.cloudflare.com/.*",
     "https://www.cockroachlabs.com/blog/.*",
-]
-fallback_extensions = ["md", "mdx", "html"]
\ No newline at end of file
+]
\ No newline at end of file

From 97e2dee548cfc835c01a8c1afd4198915d831b3c Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:09:25 -0400
Subject: [PATCH 20/53] update

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 61c5adeb1f..9dc83a320c 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -15,7 +15,7 @@ jobs:
         with:
           fail: true
           args: --verbose --no-progress './**/*.md' './**/*.mdx' './**/*.html'
-          workingDirectory: "/content"
+          workingDirectory: "~/content"
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 

From cacf9894ca188e4ad82a2a80b4c5750438ec4aa8 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:11:57 -0400
Subject: [PATCH 21/53] update

---
 .github/workflows/lychee.yml | 2 +-
 lychee.toml => .lychee.toml  | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename lychee.toml => .lychee.toml (100%)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 9dc83a320c..4ef50c5ee2 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -15,7 +15,7 @@ jobs:
         with:
           fail: true
           args: --verbose --no-progress './**/*.md' './**/*.mdx' './**/*.html'
-          workingDirectory: "~/content"
+          workingDirectory: "content"
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
diff --git a/lychee.toml b/.lychee.toml
similarity index 100%
rename from lychee.toml
rename to .lychee.toml

From 0de37397fa97127705ec60f29af45e091b32ef38 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:19:33 -0400
Subject: [PATCH 22/53] update

---
 .github/workflows/lychee.yml         | 21 ++++++++++++++++++++-
 .lychee.toml => .lychee.toml.example |  0
 2 files changed, 20 insertions(+), 1 deletion(-)
 rename .lychee.toml => .lychee.toml.example (100%)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 4ef50c5ee2..8e5be61515 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -14,7 +14,26 @@ jobs:
         uses: lycheeverse/lychee-action@v2
         with:
           fail: true
-          args: --verbose --no-progress './**/*.md' './**/*.mdx' './**/*.html'
+          args: >
+            --verbose
+            --no-progress
+            --accept 200,201,204,304,403,429
+            --timeout 20
+            --max-retries 3
+            --max-concurrency 16
+            --exclude 'http://localhost.*'
+            --exclude 'https://localhost.*'
+            --exclude '^/.*'
+            --exclude 'https://dev.mysql.com/.*'
+            --exclude 'https://www.mysql.com/.*'
+            --exclude 'https://www.npmjs.com/.*'
+            --exclude 'https://openai.com/.*'
+            --exclude 'https://platform.openai.com/.*'
+            --exclude 'https://dash.cloudflare.com/.*'
+            --exclude 'https://playground.ai.cloudflare.com/.*'
+            --exclude 'https://www.cockroachlabs.com/blog/.*'
+            --exclude-mail
+            './**/*.md' './**/*.mdx' './**/*.html'
           workingDirectory: "content"
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
diff --git a/.lychee.toml b/.lychee.toml.example
similarity index 100%
rename from .lychee.toml
rename to .lychee.toml.example

From a29ad760fa8b4f119a472bbb9acdc102bda373ea Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:21:59 -0400
Subject: [PATCH 23/53] arg changes

---
 .github/workflows/lychee.yml | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 8e5be61515..bdca0fe372 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -24,15 +24,6 @@ jobs:
             --exclude 'http://localhost.*'
             --exclude 'https://localhost.*'
             --exclude '^/.*'
-            --exclude 'https://dev.mysql.com/.*'
-            --exclude 'https://www.mysql.com/.*'
-            --exclude 'https://www.npmjs.com/.*'
-            --exclude 'https://openai.com/.*'
-            --exclude 'https://platform.openai.com/.*'
-            --exclude 'https://dash.cloudflare.com/.*'
-            --exclude 'https://playground.ai.cloudflare.com/.*'
-            --exclude 'https://www.cockroachlabs.com/blog/.*'
-            --exclude-mail
             './**/*.md' './**/*.mdx' './**/*.html'
           workingDirectory: "content"
         env:

From de06e2d0e5cf4b509e1ffc241db204d3df48460e Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:29:44 -0400
Subject: [PATCH 24/53] changed comment system

---
 .github/workflows/lychee.yml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index bdca0fe372..48d6634dff 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -11,6 +11,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Lychee Link Checker
+        id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
           fail: true
@@ -23,6 +24,9 @@ jobs:
             --max-concurrency 16
             --exclude 'http://localhost.*'
             --exclude 'https://localhost.*'
+            --exclude 'https://dev.mysql.com/.*'
+            --exclude 'https://www.mysql.com/.*'
+            --exclude 'https://www.gnu.org/.*'
             --exclude '^/.*'
             './**/*.md' './**/*.mdx' './**/*.html'
           workingDirectory: "content"
@@ -30,6 +34,8 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
       - name: Comment Broken Links
-        uses: marocchino/sticky-pull-request-comment@v2
+        if: steps.lychee.outputs.exit_code != 0
+        uses: peter-evans/create-or-update-comment@v4
         with:
-          path: lychee/out.md
+          issue-number: ${{ github.event.pull_request.number }}
+          body-path: lychee/out.md

From 24566d03fa7f1a14b5069c289d2b6f6a42a1bf1d Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:30:38 -0400
Subject: [PATCH 25/53] cache added

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 48d6634dff..4147163ebc 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -16,7 +16,7 @@ jobs:
         with:
           fail: true
           args: >
-            --verbose
+            --cache
             --no-progress
             --accept 200,201,204,304,403,429
             --timeout 20

From e2e01689851aef3930d9937af0b083f5335573f6 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:34:22 -0400
Subject: [PATCH 26/53] test

---
 .github/workflows/lychee.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 4147163ebc..ca7f82c099 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -14,7 +14,7 @@ jobs:
         id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
-          fail: true
+          fail: false
           args: >
             --cache
             --no-progress
@@ -34,7 +34,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
       - name: Comment Broken Links
-        if: steps.lychee.outputs.exit_code != 0
+        if: always()
         uses: peter-evans/create-or-update-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}

From 426be0cf4b719999562360f85377292d6b552640 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:38:42 -0400
Subject: [PATCH 27/53] output fixed

---
 .github/workflows/lychee.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index ca7f82c099..34947a26af 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -15,6 +15,7 @@ jobs:
         uses: lycheeverse/lychee-action@v2
         with:
           fail: false
+          output: ../lychee/out.md
           args: >
             --cache
             --no-progress

From f34d0ed0317606db3f98ef5fde9667b178544497 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:42:26 -0400
Subject: [PATCH 28/53] broken link to test

---
 content/800-guides/160-tanstack-start.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/800-guides/160-tanstack-start.mdx b/content/800-guides/160-tanstack-start.mdx
index f65cd8dda4..bf7f54dc1a 100644
--- a/content/800-guides/160-tanstack-start.mdx
+++ b/content/800-guides/160-tanstack-start.mdx
@@ -10,7 +10,7 @@ community_section: true
 
 ## Introduction
 
-Prisma ORM simplifies database interactions, and [TanStack Start](https://tanstack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
+Prisma ORM simplifies database interactions, and [TanStack Start](https://tanstsack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
 
 This guide will walk you through integrating Prisma ORM with a Prisma Postgres database in a TanStack Start project from scratch.
 

From d5586d715290668f82535042b13667a632993347 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:45:14 -0400
Subject: [PATCH 29/53] fail on broken links

---
 .github/workflows/lychee.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 34947a26af..4905c5a2a5 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -40,3 +40,7 @@ jobs:
         with:
           issue-number: ${{ github.event.pull_request.number }}
           body-path: lychee/out.md
+
+      - name: Fail if broken links found
+        if: steps.lychee.outputs.exit_code != 0
+        run: exit ${{ steps.lychee.outputs.exit_code }}

From 23b4f8f1e1be009374acd48f30d1fa43fa62c197 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:56:11 -0400
Subject: [PATCH 30/53] sytyle changes

---
 .github/workflows/lychee.yml | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 4905c5a2a5..ef45e0ee1f 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -18,8 +18,10 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
+            --max-cache-age 1d
             --no-progress
             --accept 200,201,204,304,403,429
+            --mode emoji
             --timeout 20
             --max-retries 3
             --max-concurrency 16
@@ -34,12 +36,26 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
+      - name: Format comment
+        if: always()
+        run: |
+          {
+            echo "## 🔗 Link Check Results"
+            echo ""
+            echo "<details>"
+            echo "<summary>View detailed results</summary>"
+            echo ""
+            cat lychee/out.md
+            echo ""
+            echo "</details>"
+          } > lychee/formatted.md
+
       - name: Comment Broken Links
         if: always()
         uses: peter-evans/create-or-update-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
-          body-path: lychee/out.md
+          body-path: lychee/formatted.md
 
       - name: Fail if broken links found
         if: steps.lychee.outputs.exit_code != 0

From 5ac4494eda2250a05218d9b10472994b2237793f Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:57:12 -0400
Subject: [PATCH 31/53] file path change

---
 .github/workflows/lychee.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index ef45e0ee1f..c5bfbdf77a 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -48,14 +48,14 @@ jobs:
             cat lychee/out.md
             echo ""
             echo "</details>"
-          } > lychee/formatted.md
+          } > lychee/out.md
 
       - name: Comment Broken Links
         if: always()
         uses: peter-evans/create-or-update-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
-          body-path: lychee/formatted.md
+          body-path: lychee/out.md
 
       - name: Fail if broken links found
         if: steps.lychee.outputs.exit_code != 0

From 9278ed2318f3b2402d8df94ed3e24f710f8e17e2 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 16:58:12 -0400
Subject: [PATCH 32/53] conflict

---
 .github/workflows/lychee.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index c5bfbdf77a..369e42d4b3 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -21,7 +21,6 @@ jobs:
             --max-cache-age 1d
             --no-progress
             --accept 200,201,204,304,403,429
-            --mode emoji
             --timeout 20
             --max-retries 3
             --max-concurrency 16

From 702a6de81564fb548687c1224790b3b752f504e3 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:01:45 -0400
Subject: [PATCH 33/53] exclusions

---
 .github/workflows/lychee.yml | 15 +--------------
 1 file changed, 1 insertion(+), 14 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 369e42d4b3..b6a18512bd 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -29,26 +29,13 @@ jobs:
             --exclude 'https://dev.mysql.com/.*'
             --exclude 'https://www.mysql.com/.*'
             --exclude 'https://www.gnu.org/.*'
+            --exclude 'https://www.cockroachlabs.com/.*'
             --exclude '^/.*'
             './**/*.md' './**/*.mdx' './**/*.html'
           workingDirectory: "content"
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
-      - name: Format comment
-        if: always()
-        run: |
-          {
-            echo "## 🔗 Link Check Results"
-            echo ""
-            echo "<details>"
-            echo "<summary>View detailed results</summary>"
-            echo ""
-            cat lychee/out.md
-            echo ""
-            echo "</details>"
-          } > lychee/out.md
-
       - name: Comment Broken Links
         if: always()
         uses: peter-evans/create-or-update-comment@v4

From 724550ba48ff729881ffe432c652fae2fc80658d Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:06:55 -0400
Subject: [PATCH 34/53] timeout and cache changes

---
 .github/workflows/lychee.yml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index b6a18512bd..9960c876da 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -18,11 +18,12 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
-            --max-cache-age 1d
+            --max-cache-age 12h
             --no-progress
             --accept 200,201,204,304,403,429
             --timeout 20
-            --max-retries 3
+            --max-retries 5
+            --retry-wait-time 5
             --max-concurrency 16
             --exclude 'http://localhost.*'
             --exclude 'https://localhost.*'
@@ -31,7 +32,7 @@ jobs:
             --exclude 'https://www.gnu.org/.*'
             --exclude 'https://www.cockroachlabs.com/.*'
             --exclude '^/.*'
-            './**/*.md' './**/*.mdx' './**/*.html'
+            './**/*.md' './**/*.mdx'
           workingDirectory: "content"
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}

From f348f2d970eb6a87f2088b20f8a128ca48eb8101 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:09:33 -0400
Subject: [PATCH 35/53] quiet flag

---
 .github/workflows/lychee.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 9960c876da..d3ec6dba65 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -18,6 +18,7 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
+            --quiet
             --max-cache-age 12h
             --no-progress
             --accept 200,201,204,304,403,429

From 1a27ecd7e20b462de4c18f2a97700b657ebd2f10 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:15:26 -0400
Subject: [PATCH 36/53] name change and old toml file removed

---
 .github/workflows/lychee.yml |  9 +++++----
 .lychee.toml.example         | 20 --------------------
 2 files changed, 5 insertions(+), 24 deletions(-)
 delete mode 100644 .lychee.toml.example

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index d3ec6dba65..13d7e236bc 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -1,9 +1,10 @@
-name: Lychee
+name: 🍈 Lychee Link Checker
 
 on: [pull_request]
 
 jobs:
-  lychee:
+  check-links:
+    name: 🔗 Check links with Lychee
     runs-on: ubuntu-latest
     permissions:
       pull-requests: write
@@ -38,13 +39,13 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
-      - name: Comment Broken Links
+      - name: 📝 Comment Broken Links
         if: always()
         uses: peter-evans/create-or-update-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
           body-path: lychee/out.md
 
-      - name: Fail if broken links found
+      - name: 🚫 Fail if broken links found
         if: steps.lychee.outputs.exit_code != 0
         run: exit ${{ steps.lychee.outputs.exit_code }}
diff --git a/.lychee.toml.example b/.lychee.toml.example
deleted file mode 100644
index 93a724e65b..0000000000
--- a/.lychee.toml.example
+++ /dev/null
@@ -1,20 +0,0 @@
-accept = [200, 201, 204, 304, 403, 429]
-cache = true
-max_retries = 3
-timeout = 20
-max_concurrency = 16
-exclude = [
-    "http://localhost.*",
-    "https://localhost.*",
-    "^/.*",
-    
-    # Third party services that return 403 for automated requests
-    "https://dev.mysql.com/.*",
-    "https://www.mysql.com/.*",
-    "https://www.npmjs.com/.*",
-    "https://openai.com/.*",
-    "https://platform.openai.com/.*",
-    "https://dash.cloudflare.com/.*",
-    "https://playground.ai.cloudflare.com/.*",
-    "https://www.cockroachlabs.com/blog/.*",
-]
\ No newline at end of file

From 70041f8eb237c0414cad6bdf17a4580f3159f227 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:15:54 -0400
Subject: [PATCH 37/53] tanstack fixed

---
 content/800-guides/160-tanstack-start.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/800-guides/160-tanstack-start.mdx b/content/800-guides/160-tanstack-start.mdx
index bf7f54dc1a..f65cd8dda4 100644
--- a/content/800-guides/160-tanstack-start.mdx
+++ b/content/800-guides/160-tanstack-start.mdx
@@ -10,7 +10,7 @@ community_section: true
 
 ## Introduction
 
-Prisma ORM simplifies database interactions, and [TanStack Start](https://tanstsack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
+Prisma ORM simplifies database interactions, and [TanStack Start](https://tanstack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
 
 This guide will walk you through integrating Prisma ORM with a Prisma Postgres database in a TanStack Start project from scratch.
 

From 0bcc831ac537b5ec81f79e6a7d58e5bdebb23f61 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:16:07 -0400
Subject: [PATCH 38/53] cache timeout changed to 6 hours

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 13d7e236bc..aeb2821edc 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -20,7 +20,7 @@ jobs:
           args: >
             --cache
             --quiet
-            --max-cache-age 12h
+            --max-cache-age 6h
             --no-progress
             --accept 200,201,204,304,403,429
             --timeout 20

From 9ff6e1390b84281406c37e2f5e055e089a9e53ed Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:20:59 -0400
Subject: [PATCH 39/53] tedt reponse

---
 .github/workflows/lychee.yml | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index aeb2821edc..54b3b24ed3 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -39,12 +39,37 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
+      - name: 📝 Clean up Lychee Report
+        if: always()
+        run: |
+          if [ -f "lychee/out.md" ]; then
+            # Read the original output
+            ORIGINAL=$(cat lychee/out.md)
+            
+            # Create formatted output
+            cat > lychee/formatted.md << 'EOF'
+          ## 🍈 Lychee Link Check Report
+
+          > **Automated link validation** — All links in documentation have been checked for availability.
+
+          > **Note:** Links are cached for 6 hours to avoid unnecessary requests.
+
+          ### 📊 Results Overview
+
+          EOF
+            
+            # Append the original content with title replacement
+            echo "$ORIGINAL" | sed 's/^# Summary$//' | sed 's/^## Summary$//' >> lychee/formatted.md
+
+          EOF
+          fi
+
       - name: 📝 Comment Broken Links
         if: always()
         uses: peter-evans/create-or-update-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
-          body-path: lychee/out.md
+          body-path: lychee/formatted.md
 
       - name: 🚫 Fail if broken links found
         if: steps.lychee.outputs.exit_code != 0

From ce7d186bb529c53d0b745e0ec5c18abe51cceefc Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:24:04 -0400
Subject: [PATCH 40/53] changes

---
 .github/workflows/lychee.yml              | 5 ++---
 content/800-guides/160-tanstack-start.mdx | 2 +-
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 54b3b24ed3..3829847c4c 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -4,14 +4,14 @@ on: [pull_request]
 
 jobs:
   check-links:
-    name: 🔗 Check links with Lychee
+    name: Check links
     runs-on: ubuntu-latest
     permissions:
       pull-requests: write
     steps:
       - uses: actions/checkout@v4
 
-      - name: Lychee Link Checker
+      - name: 🍈 Lychee Link Checker
         id: lychee
         uses: lycheeverse/lychee-action@v2
         with:
@@ -19,7 +19,6 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
-            --quiet
             --max-cache-age 6h
             --no-progress
             --accept 200,201,204,304,403,429
diff --git a/content/800-guides/160-tanstack-start.mdx b/content/800-guides/160-tanstack-start.mdx
index f65cd8dda4..309510ef35 100644
--- a/content/800-guides/160-tanstack-start.mdx
+++ b/content/800-guides/160-tanstack-start.mdx
@@ -10,7 +10,7 @@ community_section: true
 
 ## Introduction
 
-Prisma ORM simplifies database interactions, and [TanStack Start](https://tanstack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
+Prisma ORM simplifies database interactions, and [TanStack Start](https://tsanstack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
 
 This guide will walk you through integrating Prisma ORM with a Prisma Postgres database in a TanStack Start project from scratch.
 

From b9d87fe48ac434ed5d1656103af286d270535663 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:24:27 -0400
Subject: [PATCH 41/53] name change

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 3829847c4c..7148bcf9c3 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -1,4 +1,4 @@
-name: 🍈 Lychee Link Checker
+name: 🍈 Lychee
 
 on: [pull_request]
 

From 459ce7c9c51ba4fd80ba1f33c5a9714a24b8660e Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:31:11 -0400
Subject: [PATCH 42/53] broken link fixewd

---
 content/800-guides/160-tanstack-start.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/800-guides/160-tanstack-start.mdx b/content/800-guides/160-tanstack-start.mdx
index 309510ef35..f65cd8dda4 100644
--- a/content/800-guides/160-tanstack-start.mdx
+++ b/content/800-guides/160-tanstack-start.mdx
@@ -10,7 +10,7 @@ community_section: true
 
 ## Introduction
 
-Prisma ORM simplifies database interactions, and [TanStack Start](https://tsanstack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
+Prisma ORM simplifies database interactions, and [TanStack Start](https://tanstack.com/start/latest/docs/framework/react/guide/server-functions) offers a robust framework for building modern React applications. Together with [Prisma Postgres](https://www.prisma.io/postgres), they provide a seamless full-stack development experience with type-safe queries and efficient data management.
 
 This guide will walk you through integrating Prisma ORM with a Prisma Postgres database in a TanStack Start project from scratch.
 

From c6d104504b0796458c31fa193799ae36bbb22288 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:33:39 -0400
Subject: [PATCH 43/53] extra `EOF` removed

---
 .github/workflows/lychee.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 7148bcf9c3..75ccbb5388 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -59,8 +59,6 @@ jobs:
             
             # Append the original content with title replacement
             echo "$ORIGINAL" | sed 's/^# Summary$//' | sed 's/^## Summary$//' >> lychee/formatted.md
-
-          EOF
           fi
 
       - name: 📝 Comment Broken Links

From db4e9e4609fa82ae7c4d98c3c80663da9e053d53 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:40:14 -0400
Subject: [PATCH 44/53] low cache number to check

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 75ccbb5388..725e1d8131 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -19,7 +19,7 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
-            --max-cache-age 6h
+            --max-cache-age 30s
             --no-progress
             --accept 200,201,204,304,403,429
             --timeout 20

From e8602499be4ececef0a9aae416eb8bb723e3fbe7 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:41:59 -0400
Subject: [PATCH 45/53] update to only comment on non-forked prs

---
 .github/workflows/lychee.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 725e1d8131..9d627c06c4 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -39,7 +39,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
       - name: 📝 Clean up Lychee Report
-        if: always()
+        if: ${{ always() && github.event.pull_request.head.repo.fork == false }}
         run: |
           if [ -f "lychee/out.md" ]; then
             # Read the original output
@@ -62,7 +62,7 @@ jobs:
           fi
 
       - name: 📝 Comment Broken Links
-        if: always()
+        if: ${{ always() && github.event.pull_request.head.repo.fork == false }}
         uses: peter-evans/create-or-update-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}

From 51252445633c0fa639843630941c6b5cbc90058e Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:43:10 -0400
Subject: [PATCH 46/53] cache put back to 6 hours

---
 .github/workflows/lychee.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 9d627c06c4..c485e61857 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -19,7 +19,7 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
-            --max-cache-age 30s
+            --max-cache-age 6h
             --no-progress
             --accept 200,201,204,304,403,429
             --timeout 20
@@ -69,5 +69,5 @@ jobs:
           body-path: lychee/formatted.md
 
       - name: 🚫 Fail if broken links found
-        if: steps.lychee.outputs.exit_code != 0
+        if: ${{ steps.lychee.outputs.exit_code != 0 }}
         run: exit ${{ steps.lychee.outputs.exit_code }}

From ae63b7baf8e36e49c1511029b567e81cf3be09e5 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:47:50 -0400
Subject: [PATCH 47/53] cache test 1

---
 .github/workflows/lychee.yml | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index c485e61857..48d0a75fb9 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -19,7 +19,8 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
-            --max-cache-age 6h
+            --max-cache-age 30s
+            --verbose
             --no-progress
             --accept 200,201,204,304,403,429
             --timeout 20
@@ -38,6 +39,18 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
+      - name: 🔍 Check cache status
+        if: always()
+        run: |
+          echo "Checking for lychee cache..."
+          if [ -f ".lycheecache" ]; then
+            echo "✅ Cache file exists"
+            ls -lh .lycheecache
+            echo "Cache entries: $(wc -l < .lycheecache)"
+          else
+            echo "❌ No cache file found"
+          fi
+
       - name: 📝 Clean up Lychee Report
         if: ${{ always() && github.event.pull_request.head.repo.fork == false }}
         run: |

From 5e9d31ed8be480e2cb00b53097505acc14434b57 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:49:30 -0400
Subject: [PATCH 48/53] cache check removed

---
 .github/workflows/lychee.yml | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 48d0a75fb9..2cc2808773 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -39,18 +39,6 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.github_token }}
 
-      - name: 🔍 Check cache status
-        if: always()
-        run: |
-          echo "Checking for lychee cache..."
-          if [ -f ".lycheecache" ]; then
-            echo "✅ Cache file exists"
-            ls -lh .lycheecache
-            echo "Cache entries: $(wc -l < .lycheecache)"
-          else
-            echo "❌ No cache file found"
-          fi
-
       - name: 📝 Clean up Lychee Report
         if: ${{ always() && github.event.pull_request.head.repo.fork == false }}
         run: |

From 88b897822dc222acb50b5ffcf2d85fca863ecb7c Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:51:16 -0400
Subject: [PATCH 49/53] cache changed to 5 minutes for test

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 2cc2808773..f0244b23d1 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -19,7 +19,7 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
-            --max-cache-age 30s
+            --max-cache-age 5m
             --verbose
             --no-progress
             --accept 200,201,204,304,403,429

From 252e1e928dc99cc06a3c456b4e02ba99bbdb4f51 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:53:53 -0400
Subject: [PATCH 50/53] cache 3 hours

---
 .github/workflows/lychee.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index f0244b23d1..4f5656e3dd 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -19,7 +19,7 @@ jobs:
           output: ../lychee/out.md
           args: >
             --cache
-            --max-cache-age 5m
+            --max-cache-age 3h
             --verbose
             --no-progress
             --accept 200,201,204,304,403,429

From 4cf78dc41744739d89f29500b18ae5a48501f28b Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:56:34 -0400
Subject: [PATCH 51/53] concurrency checks added

---
 .github/workflows/lychee.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index 4f5656e3dd..c7239ac093 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -2,6 +2,10 @@ name: 🍈 Lychee
 
 on: [pull_request]
 
+concurrency:
+  group: lychee-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
 jobs:
   check-links:
     name: Check links

From 19887ad1a1e72a48dcb9bc885aab54b8dc23fadc Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Tue, 21 Oct 2025 17:57:27 -0400
Subject: [PATCH 52/53] test: trigger lychee workflow


From 44e36758e2b2f03c95ef9aa2e9de79693b8bfc67 Mon Sep 17 00:00:00 2001
From: Aidan McAlister <aidankmcalister@gmail.com>
Date: Wed, 22 Oct 2025 10:04:29 -0400
Subject: [PATCH 53/53] minor text change

---
 .github/workflows/lychee.yml | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/.github/workflows/lychee.yml b/.github/workflows/lychee.yml
index c7239ac093..257b7dded9 100644
--- a/.github/workflows/lychee.yml
+++ b/.github/workflows/lychee.yml
@@ -54,9 +54,7 @@ jobs:
             cat > lychee/formatted.md << 'EOF'
           ## 🍈 Lychee Link Check Report
 
-          > **Automated link validation** — All links in documentation have been checked for availability.
-
-          > **Note:** Links are cached for 6 hours to avoid unnecessary requests.
+          > **Note:** Links are cached for 3 hours to avoid unnecessary requests, and speed up consecutive runs.
 
           ### 📊 Results Overview