refactor: Isolated docs deployment

Author: d3xter666

.github/workflows/deploy-vitepress-docs.yaml

@@ -40,18 +40,21 @@ jobs:
                 cache: npm
             - name: Setup Pages
               uses: actions/configure-pages@v4
-            - name: Install dependencies
-              run: npm ci --engine-strict # --engine-strict is used to fail-fast if deps require node versions unsupported by the repo
-            - name: Install documentation dependencies
-              working-directory: internal/documentation
-              run: npm ci --engine-strict # --engine-strict is used to fail-fast if deps require node versions unsupported by the repo
+            - name: Copy documentation package to isolated directory
+              run: |
+                  # Create isolated directory for documentation
+                  mkdir -p /tmp/isolated-docs
+                  cp -r internal/documentation/. /tmp/isolated-docs/
+            - name: Install documentation dependencies from NPM
+              working-directory: /tmp/isolated-docs
+              run: npm ci --engine-strict
             - name: Fetch gh-pages branch
               run: git fetch origin gh-pages --depth=1
             - name: generate CLI doc
-              working-directory: internal/documentation
+              working-directory: /tmp/isolated-docs
               run: npm run generate-cli-doc
             - name: Build vitepress build
-              working-directory: internal/documentation
+              working-directory: /tmp/isolated-docs
               run: |
                 # The base output
                 npm run build:vitepress -- --base="/${{ github.event.repository.name }}/${DOC_VERSION}/"
@@ -60,11 +63,10 @@ jobs:
                 npm run build:vitepress -- --base="/${{ github.event.repository.name }}/${DOC_ALIAS}/" --outDir="dist-${DOC_ALIAS}"
                 npm run build:assets -- ./dist-${DOC_ALIAS}
             - name: Build jsdoc
-              working-directory: internal/documentation
+              working-directory: /tmp/isolated-docs
               run: npm run jsdoc-generate
             # TODO: Skip for now deployment of the schema until we do a Schema Version 5 release
-            # - name: Build Schema
-            #   run: |
+            # - name: Build Sch3 |
             #       npm run schema-generate
             #       npm run schema-workspace-generate
             - name: Checkout gh-pages
@@ -81,16 +83,16 @@ jobs:
                   rm -rf ./gh-pages/${DOC_ALIAS}
 
                   # Main version route
-                  cp -R ./internal/documentation/dist ./gh-pages/${DOC_VERSION}/
+                  cp -R /tmp/isolated-docs/dist ./gh-pages/${DOC_VERSION}/
 
                   # Alias route. E.g., next, latest, stable, etc.
                   # For vitepress must be a copy with different config, not a symlink
-                  cp -R ./internal/documentation/dist-${DOC_ALIAS} ./gh-pages/${DOC_ALIAS}/
+                  cp -R /tmp/isolated-docs/dist-${DOC_ALIAS} ./gh-pages/${DOC_ALIAS}/
                   # Symlink the api docs to avoid duplication
                   ln -s ../${DOC_VERSION}/api ./gh-pages/${DOC_ALIAS}/api
 
                   # TODO: Enable when v5 release is done
-                  # cp ./internal/documentation/scripts/resources/custom404.html ./gh-pages/404.html
+                  # cp /tmp/isolated-docs/scripts/resources/custom404.html ./gh-pages/404.html
             - name: Publish Docs
               run: |
                   cd ./gh-pages