Merge remote-tracking branch 'origin/main' into jd-pingcastle33-update

Author: JoeDibley

.github/workflows/deploy.yml

@@ -5,109 +5,46 @@ on:
     branches: [dev, main]
   pull_request:
     branches: [dev, main]
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Environment to deploy to'
+        required: true
+        default: 'development'
+        type: choice
+        options:
+          - development
+          - production
 
 # Prevent multiple concurrent deployments
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: false
 
 jobs:
-  build:
-    name: Build Documentation
-    runs-on: ubuntu-latest
-    timeout-minutes: 90
-    outputs:
-      environment: ${{ steps.set-env.outputs.environment }}
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Determine environment
-        id: set-env
-        run: |
-          if [[ "${{ github.ref }}" == "refs/heads/main" ]] || [[ "${{ github.event_name }}" == "pull_request" && "${{ github.base_ref }}" == "main" ]]; then
-            echo "environment=Production" >> $GITHUB_OUTPUT
-            echo "SITE_URL=${{ secrets.PROD_URL }}" >> $GITHUB_ENV
-          else
-            echo "environment=Development" >> $GITHUB_OUTPUT
-            echo "SITE_URL=${{ secrets.DEV_URL }}" >> $GITHUB_ENV
-          fi
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          cache: 'npm'
-
-      - name: Cache Docusaurus build
-        uses: actions/cache@v4
-        with:
-          path: |
-            .docusaurus
-            .cache
-            build/.cache
-          key: ${{ runner.os }}-docusaurus-build-${{ steps.set-env.outputs.environment }}-${{ hashFiles('**/package-lock.json', '**/docusaurus.config.js', 'docs/**/*.md', 'docs/**/*.mdx') }}
-          restore-keys: |
-            ${{ runner.os }}-docusaurus-build-${{ steps.set-env.outputs.environment }}-
-            ${{ runner.os }}-docusaurus-build-
-
-      - name: Cache webpack
-        uses: actions/cache@v4
-        with:
-          path: node_modules/.cache
-          key: ${{ runner.os }}-webpack-${{ steps.set-env.outputs.environment }}-${{ hashFiles('**/package-lock.json') }}
-          restore-keys: |
-            ${{ runner.os }}-webpack-${{ steps.set-env.outputs.environment }}-
-            ${{ runner.os }}-webpack-
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build site
-        run: npm run build
-        env:
-          RENDER_EXTERNAL_URL: ${{ env.SITE_URL }}
-
-      - name: Validate build output
-        run: |
-          if [ ! -d "build" ]; then
-            echo "❌ Build directory not found!"
-            exit 1
-          fi
-          echo "✅ Build directory exists with $(find build -type f | wc -l) files"
-
-      - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: build-${{ steps.set-env.outputs.environment }}
-          path: build/
-          retention-days: 1
-
   deploy-dev:
     name: Deploy to Development
-    needs: build
     runs-on: ubuntu-latest
     environment: Development
-    if: (github.ref == 'refs/heads/dev' || (github.event_name == 'pull_request' && github.base_ref == 'dev')) && needs.build.outputs.environment == 'Development'
+    # Run for: dev branch pushes, PRs targeting dev, or manual dispatch to development
+    if: |
+      github.ref == 'refs/heads/dev' || 
+      (github.event_name == 'pull_request' && github.base_ref == 'dev') ||
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'development')
     permissions:
       deployments: write
-      pull-requests: write  # Needed to comment on PRs
+      pull-requests: write
     steps:
-      - name: Download build artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: build-Development
-          path: build/
-
-      - name: Deploy to Render Dev
+      - name: Trigger Render Deploy
         id: deploy
         uses: JorgeLNJunior/[email protected]
         with:
-          service_id: ${{ secrets.RENDER_SERVICE_ID }}
+          service_id: ${{ vars.RENDER_SERVICE_ID }}
           api_key: ${{ secrets.RENDER_API_KEY }}
+          clear_cache: false
           wait_deploy: true
           github_deployment: true
-          deployment_environment: ${{ secrets.RENDER_DEPLOY_ENVIRONMENT }}
+          deployment_environment: ${{ vars.RENDER_DEPLOY_ENVIRONMENT }}
           github_token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Comment on PR
@@ -116,7 +53,7 @@ jobs:
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
-            const deployUrl = '${{ secrets.SITE_URL }}';
+            const deployUrl = '${{ vars.SITE_URL }}';
             const environment = 'Development';
             const commentIdentifier = `<!-- deployment-bot:${environment} -->`;
             
@@ -165,29 +102,27 @@ jobs:
 
   deploy-prod:
     name: Deploy to Production
-    needs: build
     runs-on: ubuntu-latest
     environment: Production
-    if: (github.ref == 'refs/heads/main' || (github.event_name == 'pull_request' && github.base_ref == 'main')) && needs.build.outputs.environment == 'Production'
+    # Run for: main branch pushes, PRs targeting main, or manual dispatch to production
+    if: |
+      github.ref == 'refs/heads/main' || 
+      (github.event_name == 'pull_request' && github.base_ref == 'main') ||
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'production')
     permissions:
       deployments: write
-      pull-requests: write  # Needed to comment on PRs
+      pull-requests: write
     steps:
-      - name: Download build artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: build-Production
-          path: build/
-
-      - name: Deploy to Render Prod
+      - name: Trigger Render Deploy
         id: deploy
         uses: JorgeLNJunior/[email protected]
         with:
-          service_id: ${{ secrets.RENDER_SERVICE_ID }}
+          service_id: ${{ vars.RENDER_SERVICE_ID }}
           api_key: ${{ secrets.RENDER_API_KEY }}
+          clear_cache: false
           wait_deploy: true
           github_deployment: true
-          deployment_environment: ${{ secrets.RENDER_DEPLOY_ENVIRONMENT }}
+          deployment_environment: ${{ vars.RENDER_DEPLOY_ENVIRONMENT }}
           github_token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Comment on PR
@@ -196,7 +131,7 @@ jobs:
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
-            const deployUrl = '${{ secrets.SITE_URL }}';
+            const deployUrl = '${{ vars.SITE_URL }}';
             const environment = 'Production';
             const commentIdentifier = `<!-- deployment-bot:${environment} -->`;
             

.gitignore

@@ -1,6 +1,9 @@
 # Dependencies
 /node_modules
 
+# VS Code
+.vscode/
+
 # Generated files
 .docusaurus
 .cache-loader
@@ -16,10 +19,4 @@ claude_logs
 
 npm-debug.log*
 yarn-debug.log*
-yarn-error.log*
-
-# MDX Test Reports
-mdx-test-report.json
-pre-conversion-report.json
-post-conversion-report.json
-*.test-report.json
+yarn-error.log*

.husky/pre-commit

@@ -39,12 +39,8 @@ cd docs
 # Install dependencies
 npm install
 
-# Start development server (all products)
+# Start development server
 npm run start
-
-# Single product mode (recommended for development)
-npm run start 1secure
-npm run start accessanalyzer/12.0
 ```
 
 ## 📁 Project Structure
@@ -79,8 +75,7 @@ npm run start accessanalyzer/12.0
 │   │   └── 12.0.js
 │   └── [other product sidebars]/
 ├── scripts/                     # Development utilities
-│   ├── start-wrapper.js         # Single-product dev mode
-│   └── build-single.js          # Single-product builds
+
 ├── static/                      # Static assets
 │   └── img/
 │       ├── branding/            # Logos and brand assets
@@ -95,41 +90,25 @@ npm run start accessanalyzer/12.0
 
 ```bash
 # Development
-npm run start                     # All products (slower, loads everything)
-npm run start [product]           # start a solo product docs only
-npm run start [product]/[version] # start a versioned product docs only
+npm run start                     # Start development server
 
 # Building & Testing
 npm run build                     # Full production build
-npm run build [product]           # Full production build
-npm run build [product]/[version] # Full production build
-npm run format:check              # Check code formatting
-npm run format                    # Auto-format with Prettier
+
 # Utilities
 npm run clear                     # Clear Docusaurus cache
 npm run serve                     # Serve production build after `npm run build`
 ```
 
 ### Development Workflow
 
-The new centralized system makes development much simpler:
+The centralized system makes development simple:
 
 1. **Start development server**: `npm run start`
 2. **Make changes** to documentation or configuration
 3. **Hot reload** automatically updates the site
 4. **All products and versions** work seamlessly
 
-### Single Product Development (Legacy Script Support)
-
-For backward compatibility, single-product scripts still work:
-
-```bash
-# Examples (optional - full site starts quickly now)
-npm run start 1secure
-npm run start accessanalyzer/12.0
-npm run start identitymanager/saas
-```
-
 ## ⚙️ Centralized Configuration System
 
 ### Global Product Config: `src/config/products.js`
@@ -369,31 +348,15 @@ Contributing is easy:
 npm run start
 ```
 
-2. **Make changes** to documentation or configuration
-
-3. **Format code** before committing:
-
-If this isn't done, a pre-commit hook will do it for you anyways.
-
-```bash
-npm run format
-```
-
-4. **Test builds**:
-
-Test a build of the docs you edited:
-
-```bash
-npm run build [product][/version]
-```
+2. **Make your changes** to documentation or configuration
 
-Test a build of all docs:
+3. **Test builds**:
 
 ```bash
 npm run build
 ```
 
-5. **Submit pull request**
+4. **Submit pull request**
 
 Create a PR to the dev branch, and then main when ready for production.