revert: undo multi-version docs PR #113 (actions not allowed by org policy)

Author: emjay0921

.github/workflows/build_deploy.yml

@@ -1,13 +1,9 @@
-name: Build and deploy OpenSPP documentation (previews only)
-
-# NOTE: stable branch is now handled by build_deploy_multiversion.yml
-# This workflow only handles preview deployments for other branches
+name: Build and deploy OpenSPP documentation
 
 on:
   push:
     branches-ignore:
       - cf-pages
-      - stable  # stable is handled by multiversion workflow
 
 jobs:
   build_deploy:
@@ -36,15 +32,27 @@ jobs:
 
       # Set safe branch name for preview deployments
       - name: Set safe branch name
+        if: github.ref != 'refs/heads/stable'
         id: branch
         run: |
           # Sanitize branch name: only allow alphanumeric, dots, underscores, hyphens
           # Replace all other characters with hyphens and limit to 50 characters
           SAFE_NAME=$(echo ${GITHUB_REF_NAME} | sed 's/[^a-zA-Z0-9._-]/-/g' | cut -c1-50)
           echo "safe=${SAFE_NAME}" >> $GITHUB_OUTPUT
 
-      # Build preview documentation
+      # Build documentation with appropriate environment variables
+      - name: Prepare deploy (stable)
+        if: github.ref == 'refs/heads/stable'
+        run: |
+          set -e  # Exit on error
+          export DOCS_VERSION=stable
+          export DOCS_BASEURL=https://docs.openspp.org/
+          export IS_PREVIEW=0
+          export DOCS_GITHUB_VERSION=stable
+          make deploy || { echo "Build failed"; exit 1; }
+
       - name: Prepare deploy (preview)
+        if: github.ref != 'refs/heads/stable'
         run: |
           set -e  # Exit on error
           export DOCS_VERSION=${{ steps.branch.outputs.safe }}
@@ -53,8 +61,19 @@ jobs:
           export DOCS_GITHUB_VERSION=${GITHUB_REF_NAME}
           make deploy || { echo "Build failed"; exit 1; }
 
-      # Deploy preview documentation
+      # Deploy stable documentation (main branch)
+      - name: Deploy stable documentation (to cf-pages branch)
+        if: github.ref == 'refs/heads/stable'
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: _build/html
+          publish_branch: cf-pages
+          keep_files: true  # Don't delete preview versions
+
+      # Deploy preview documentation (non-main branches)
       - name: Deploy preview documentation (to cf-pages branch)
+        if: github.ref != 'refs/heads/stable'
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -65,5 +84,9 @@ jobs:
 
       - name: Display deployment status
         run: |
-          BRANCH_SAFE=$(echo ${GITHUB_REF_NAME} | sed 's/\//-/g')
-          echo "✅ Deployed preview documentation to https://docs.openspp.org/previews/${BRANCH_SAFE}/"
+          if [ "${{ github.ref }}" == "refs/heads/stable" ]; then
+            echo "✅ Deployed stable documentation to https://docs.openspp.org/"
+          else
+            BRANCH_SAFE=$(echo ${GITHUB_REF_NAME} | sed 's/\//-/g')
+            echo "✅ Deployed preview documentation to https://docs.openspp.org/previews/${BRANCH_SAFE}/"
+          fi

.github/workflows/build_deploy_multiversion.yml

@@ -1,12 +1,12 @@
 [
   {
-    "name": "2.0 (latest)",
-    "version": "2.0",
+    "name": "stable (latest)",
+    "version": "stable",
     "url": "https://docs.openspp.org/"
   },
   {
     "name": "1.3",
     "version": "1.3",
-    "url": "https://docs.openspp.org/v1.3/"
+    "url": "https://docs.openspp.org/1.3/"
   }
 ]

docs/_static/switcher.json

@@ -28,11 +28,11 @@ document.addEventListener('DOMContentLoaded', function() {
                     // Get current page path, removing any version prefix
                     let currentPath = window.location.pathname;
 
-                    // Remove version prefixes: /previews/branch-name/ or /v1.3/ or /1.3/
+                    // Remove version prefixes: /previews/branch-name/ or /version/
                     // This regex matches /previews/anything/ at the start
                     currentPath = currentPath.replace(/^\/previews\/[^\/]+\//, '/');
-                    // This regex matches /v1.3/ or /1.3/ patterns at the start (with optional 'v' prefix)
-                    currentPath = currentPath.replace(/^\/v?[0-9.]+\//, '/');
+                    // This regex matches /version-number/ patterns at the start
+                    currentPath = currentPath.replace(/^\/[0-9.]+\//, '/');
                     // Remove leading slash since newUrl already has trailing slash
                     currentPath = currentPath.replace(/^\/+/, '');