diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index c920db365822d..0f854b9e4572d 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -22,6 +22,6 @@ jobs:
           node-version: 20
 
       - name: Run link checker
-        run: cd docs && pnpm run check-links
+        run: cd docs/link-checker && pnpm run check-links
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/docs/README.MD b/docs/link-checker/README.MD
similarity index 100%
rename from docs/README.MD
rename to docs/link-checker/README.MD
diff --git a/docs/package.json b/docs/link-checker/package.json
similarity index 100%
rename from docs/package.json
rename to docs/link-checker/package.json
diff --git a/docs/src/markdown.ts b/docs/link-checker/src/markdown.ts
similarity index 100%
rename from docs/src/markdown.ts
rename to docs/link-checker/src/markdown.ts
diff --git a/docs/src/validate-docs-links.ts b/docs/link-checker/src/validate-docs-links.ts
similarity index 100%
rename from docs/src/validate-docs-links.ts
rename to docs/link-checker/src/validate-docs-links.ts
diff --git a/docs/tsconfig.json b/docs/link-checker/tsconfig.json
similarity index 100%
rename from docs/tsconfig.json
rename to docs/link-checker/tsconfig.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 505b8f10d85f3..b8f7765ce035c 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -52,7 +52,7 @@ importers:
         specifier: workspace:*
         version: link:../packages/turbo-releaser
 
-  docs:
+  docs/link-checker:
     dependencies:
       github-slugger:
         specifier: 2.0.0
@@ -3398,7 +3398,7 @@ packages:
   /@types/hast@3.0.4:
     resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
     dependencies:
-      '@types/unist': 2.0.10
+      '@types/unist': 3.0.3
     dev: false
 
   /@types/http-cache-semantics@4.0.1:
@@ -3467,7 +3467,7 @@ packages:
   /@types/mdast@4.0.4:
     resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
     dependencies:
-      '@types/unist': 2.0.10
+      '@types/unist': 3.0.3
     dev: false
 
   /@types/minimatch@5.1.1:
@@ -3564,10 +3564,6 @@ packages:
   /@types/tinycolor2@1.4.3:
     resolution: {integrity: sha512-Kf1w9NE5HEgGxCRyIcRXR/ZYtDv0V8FVPtYHwLxl0O+maGX0erE77pQlD0gpP+/KByMZ87mOA79SjifhSB3PjQ==}
 
-  /@types/unist@2.0.10:
-    resolution: {integrity: sha512-IfYcSBWE3hLpBg8+X2SEa8LVkJdJEkT2Ese2aaLs3ptGdVtABxndrMaxuFlQ1qdFf9Q5rDvDpxI3WwgvKFAsQA==}
-    dev: false
-
   /@types/unist@3.0.3:
     resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
     dev: false
@@ -5363,6 +5359,7 @@ packages:
 
   /direction@2.0.1:
     resolution: {integrity: sha512-9S6m9Sukh1cZNknO1CWAr2QAWsbKLafQiyM5gZ7VgXHeuaoUwffKN4q6NC4A/Mf9iiPlOXQEKW/Mv/mh9/3YFA==}
+    hasBin: true
     dev: false
 
   /dirs-next@0.0.1-canary.1:
@@ -8746,6 +8743,7 @@ packages:
 
   /js-yaml@3.14.1:
     resolution: {integrity: sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==}
+    hasBin: true
     dependencies:
       argparse: 1.0.10
       esprima: 4.0.1
@@ -11834,6 +11832,7 @@ packages:
   /tsx@4.19.1:
     resolution: {integrity: sha512-0flMz1lh74BR4wOvBjuh9olbnwqCPc35OOlfyzHba0Dc+QNUeWX/Gq2YTbnwcWPO3BMd8fkzRVrHcsR+a7z7rA==}
     engines: {node: '>=18.0.0'}
+    hasBin: true
     dependencies:
       esbuild: 0.23.1
       get-tsconfig: 4.7.6
@@ -11982,6 +11981,7 @@ packages:
   /typescript@5.5.4:
     resolution: {integrity: sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==}
     engines: {node: '>=14.17'}
+    hasBin: true
 
   /uglify-js@3.17.4:
     resolution: {integrity: sha512-T9q82TJI9e/C1TAxYvfb16xO120tMVFZrGA3f9/P4424DNu6ypK103y0GPFVa17yotwSyZW5iYXgjYHkGrJW/g==}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 7c8fa007f0575..4a7f9ac27919b 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -1,7 +1,7 @@
 packages:
   - ".github/actions/*"
   - "cli"
-  - "docs"
+  - "docs/*"
   - "packages/*"
   - "turborepo-tests/*"
   # Intentionally exclude the `npm` `turbo` package from the workspaces.