docs: update v1 references to link to hosted V1 API docs (#1584)

.github/workflows/deploy-docs.yml

@@ -0,0 +1,53 @@
+name: Deploy Docs
+
+on:
+    push:
+        branches:
+            - main
+            - v1.x
+    workflow_dispatch:
+
+concurrency:
+    group: deploy-docs
+    cancel-in-progress: true
+
+jobs:
+    deploy-docs:
+        runs-on: ubuntu-latest
+
+        permissions:
+            contents: read
+            pages: write
+            id-token: write
+
+        environment:
+            name: github-pages
+            url: ${{ steps.deployment.outputs.page_url }}
+
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Install pnpm
+              uses: pnpm/action-setup@v4
+              with:
+                  run_install: false
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: 24
+                  cache: pnpm
+                  cache-dependency-path: pnpm-lock.yaml
+
+            - name: Generate multi-version docs
+              run: bash scripts/generate-multidoc.sh tmp/docs-combined
+
+            - name: Configure Pages
+              uses: actions/configure-pages@v5
+
+            - name: Upload Pages artifact
+              uses: actions/upload-pages-artifact@v3
+              with:
+                  path: tmp/docs-combined
+
+            - name: Deploy to GitHub Pages
+              id: deployment
+              uses: actions/deploy-pages@v4

.github/workflows/main.yml

@@ -109,13 +109,14 @@ jobs:
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-    # Generates API documentation and deploys to GitHub Pages on any release
+    # Generates API documentation (V1 + V2) and deploys to GitHub Pages on any release
     deploy-docs:
         runs-on: ubuntu-latest
         if: github.event_name == 'release'
         needs: [publish]
 
         permissions:
+            contents: read
             pages: write
             id-token: write
 
@@ -136,14 +137,8 @@ jobs:
                   cache: pnpm
                   cache-dependency-path: pnpm-lock.yaml
 
-            - name: Install dependencies
-              run: pnpm install
-
-            - name: Build packages
-              run: pnpm build:all
-
-            - name: Generate documentation
-              run: pnpm docs
+            - name: Generate multi-version docs
+              run: bash scripts/generate-multidoc.sh tmp/docs-combined
 
             - name: Configure Pages
               uses: actions/configure-pages@v5
@@ -151,7 +146,7 @@ jobs:
             - name: Upload Pages artifact
               uses: actions/upload-pages-artifact@v3
               with:
-                  path: tmp/docs
+                  path: tmp/docs-combined
 
             - name: Deploy to GitHub Pages
               id: deployment