fix(ci): correct cache path mismatch between stage-and-check and deploy jobs

- Standardize cache staging directory from 'deploy-staging/' to 'stage/'
- Ensures cache save and restore paths match
- Fixes 'fail-on-cache-miss: true' cache miss error
- Updates all references in organize, cache, and validation steps

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>

Author: skjnldsv

.github/workflows/sphinxbuild.yml

@@ -326,7 +326,7 @@ jobs:
           branch="${{ steps.branch.outputs.branch_name }}"
 
           # Create the branch folder directly
-          mkdir -p "deploy-staging/${branch}"
+          mkdir -p "stage/${branch}"
 
           # Copy artifacts preserving their manual folder structure
           # Each artifact (user_manual, admin_manual, developer_manual) contains
@@ -335,20 +335,20 @@ jobs:
             if [ -d "$artifact" ]; then
               manual_name="$(basename "$artifact")"
               # Create the manual-specific folder
-              mkdir -p "deploy-staging/${branch}/${manual_name}"
+              mkdir -p "stage/${branch}/${manual_name}"
               # Copy artifact contents into the manual folder
-              cp -r "$artifact/"* "deploy-staging/${branch}/${manual_name}/"
+              cp -r "$artifact/"* "stage/${branch}/${manual_name}/"
             fi
           done
 
           # Move PDF files to the root of the branch folder for cleaner structure
-          find "deploy-staging/${branch}/" -maxdepth 2 -name "*.pdf" -type f -exec mv {} "deploy-staging/${branch}/" \;
+          find "stage/${branch}/" -maxdepth 2 -name "*.pdf" -type f -exec mv {} "stage/${branch}/" \;
 
           # Clean up empty directories
-          find deploy-staging -type d -empty -delete
+          find stage -type d -empty -delete
 
           echo "Staged artifacts for ${branch}:"
-          find deploy-staging -type f | head -20
+          find stage -type f | head -20
 
       # ========================================================================
       # CACHE STAGING ARTIFACTS
@@ -359,7 +359,7 @@ jobs:
       - name: Cache staged artifacts
         uses: actions/cache/save@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
         with:
-          path: deploy-staging/
+          path: stage/
           key: staged-docs-${{ github.sha }}
 
       # ========================================================================
@@ -381,7 +381,7 @@ jobs:
 
           # Merge in the new artifacts
           mkdir -p "full-context/server/${branch}"
-          cp -r "deploy-staging/${branch}/"* "full-context/server/${branch}/" || true
+          cp -r "stage/${branch}/"* "full-context/server/${branch}/" || true
 
           echo "Validation structure ready:"
           find full-context -type d -maxdepth 2
@@ -398,7 +398,6 @@ jobs:
             --no-progress
             --remap 'https://docs.nextcloud.com/server/ file://$(pwd)/full-context/server/'
             --exclude 'mailto:'
-            --exclude '(https?:/?/?)?$'
             --exclude-path '.*/404\.html'
             'full-context/server/${{ steps.branch.outputs.branch_name }}/**/*.html'
 
@@ -499,6 +498,10 @@ jobs:
             echo "has_changes=true" >> $GITHUB_OUTPUT
           fi
 
+        # Remove the stage/ directory BEFORE creating the PR so it doesn't get committed
+      - name: Clean up staging cache before commit
+        run: rm -rf stage/
+
       - name: Create Pull Request for documentation deployment
         uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
         id: cpr