fix(ci): resolve baseUrl in docs link check

The Validate links step ran hyperlink against docs/build directly, but
the site baseUrl is /javascript/, so every internal link is emitted as
/javascript/... . hyperlink treats the target dir as server root, so
those site-absolute links resolved to a nonexistent /javascript prefix
and produced ~21k false 'bad link' errors (0 bad anchors).

Stage the build under a javascript/ subdir and point hyperlink at the
parent so links resolve. Also drop --sources (reporting-only, does not
affect pass/fail) and gitignore the _linkcheck scratch dir.

Author: davidgamero

.github/workflows/deploy-docs-v2.yml

@@ -27,7 +27,15 @@ jobs:
               run: npm run build
               working-directory: docs
             - name: Validate links and anchors
-              run: npx @untitaker/hyperlink docs/build --check-anchors --sources docs/docs
+              # Docusaurus baseUrl is /javascript/, so all internal links are emitted
+              # as /javascript/... . hyperlink treats the given dir as server root "/",
+              # so the build must be staged under a matching javascript/ subdirectory
+              # for site-absolute links to resolve.
+              run: |
+                  rm -rf _linkcheck
+                  mkdir -p _linkcheck/javascript
+                  cp -R docs/build/. _linkcheck/javascript/
+                  npx @untitaker/hyperlink _linkcheck --check-anchors
             - name: Deploy to gh-pages
               if: github.event_name == 'push'
               uses: JamesIves/github-pages-deploy-action@d92aa235d04922e8f08b40ce78cc5442fcfbfa2f # v4.8.0

.gitignore

@@ -18,4 +18,7 @@ docs/*
 # Docusaurus
 website/.docusaurus
 website/build
-website/node_modules
+website/node_modules
+
+# Link-check scratch dir (created by docs CI to stage build under baseUrl)
+_linkcheck/