♻️ Change to reuse the document operation reusable workflow at the document CI/CD workflows.

Author: Chisanan232

.github/workflows/docs-build-check.yaml

@@ -7,27 +7,27 @@ on:
       - ".github/workflows/docs-build-check.yaml"
       - ".github/workflows/documentation.yaml"
       # Documentation dependencies
-      - "docs/package.json"
-      - "docs/pnpm-lock.yaml"
+      - "docs_with_docusarus/package.json"
+      - "docs_with_docusarus/pnpm-lock.yaml"
       # Docusaurus configuration
-      - "docs/docusaurus.config.ts"
-      - "docs/tsconfig.json"
+      - "docs_with_docusarus/docusaurus.config.ts"
+      - "docs_with_docusarus/tsconfig.json"
       # Documentation content
-      - "docs/**/*.md"
-      - "docs/**/*.mdx"
-      - "docs/**/*.ts"
-      - "docs/**/*.tsx"
-      - "docs/**/*.js"
-      - "docs/**/*.jsx"
-      - "docs/**/*.css"
-      - "docs/**/*.json"
+      - "docs_with_docusarus/**/*.md"
+      - "docs_with_docusarus/**/*.mdx"
+      - "docs_with_docusarus/**/*.ts"
+      - "docs_with_docusarus/**/*.tsx"
+      - "docs_with_docusarus/**/*.js"
+      - "docs_with_docusarus/**/*.jsx"
+      - "docs_with_docusarus/**/*.css"
+      - "docs_with_docusarus/**/*.json"
       # Docusaurus versioning
-      - "docs/*_versions.json"
-      - "docs/*_versioned_docs/**"
-      - "docs/*_versioned_sidebars/**"
+      - "docs_with_docusarus/*_versions.json"
+      - "docs_with_docusarus/*_versioned_docs/**"
+      - "docs_with_docusarus/*_versioned_sidebars/**"
       # Static assets
-      - "docs/static/**"
-      - "docs/src/**"
+      - "docs_with_docusarus/static/**"
+      - "docs_with_docusarus/src/**"
 
 permissions:
   contents: read
@@ -38,63 +38,29 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  build_docs:
-    name: Build Documentation
+  build_and_test_docs:
+    name: Build & Test Documentation
+    uses: Chisanan232/GitHub-Action_Reusable_Workflows-Python/.github/workflows/rw_docusaurus_operations.yaml@master
+    with:
+      operation: test
+      node-version: '22'
+      working-directory: docs_with_docusarus
+      upload-artifacts: true
+
+  validate_build:
+    name: Validate Build Quality
+    needs: build_and_test_docs
     runs-on: ubuntu-latest
-    
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v5
-        with:
-          fetch-depth: 1  # Shallow clone for build check
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
+      - name: Download build artifacts
+        uses: actions/download-artifact@v6
         with:
-          version: 10
-          run_install: false
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
-        with:
-          node-version: '22'
-          cache: 'pnpm'
-          cache-dependency-path: docs/pnpm-lock.yaml
-
-      - name: Install dependencies
-        working-directory: ./docs
-        run: pnpm install --frozen-lockfile
-
-#      - name: Type check
-#        working-directory: ./docs
-#        run: pnpm typecheck
-
-      - name: Build documentation
-        working-directory: ./docs
-        run: pnpm build
-
-      - name: Check build output
-        run: |
-          if [ ! -d "docs/build" ]; then
-            echo "❌ Build directory not found!"
-            exit 1
-          fi
-          
-          if [ ! -f "docs/build/index.html" ]; then
-            echo "❌ Main index.html not generated!"
-            exit 1
-          fi
-          
-          # Check for common build artifacts
-          BUILD_SIZE=$(du -sh docs/build | cut -f1)
-          echo "✅ Documentation built successfully!"
-          echo "📁 Build size: $BUILD_SIZE"
-          echo "📄 Files generated: $(find docs/build -type f | wc -l)"
+          name: documentation-build
+          path: docs_with_docusarus/build
 
       - name: Validate build quality
         run: |
-          # Check for broken links in build output (basic validation)
-          cd docs/build
+          cd docs_with_docusarus/build
           
           # Count HTML files
           HTML_COUNT=$(find . -name "*.html" | wc -l)

.github/workflows/documentation.yaml

@@ -58,7 +58,7 @@ jobs:
 
       - name: Download docs update flag from release workflow
         if: github.event_name == 'workflow_run'
-        uses: actions/download-artifact@v5
+        uses: actions/download-artifact@v6
         with:
           name: release-docs-flag
           github-token: ${{ secrets.GITHUB_TOKEN }}
@@ -90,51 +90,43 @@ jobs:
             echo "should_deploy=false" >> $GITHUB_OUTPUT
           fi
 
-  deploy_documentation:
-    runs-on: ubuntu-latest
-    # Run based on the check_docs_changes job output (which handles both push and workflow_run events)
+  build_documentation:
+    name: Build Documentation
     if: needs.check_docs_changes.outputs.should_deploy == 'true'
     needs: [check_docs_changes]
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-        with:
-          fetch-depth: 0
+    uses: Chisanan232/GitHub-Action_Reusable_Workflows-Python/.github/workflows/rw_docusaurus_operations.yaml@master
+    with:
+      operation: build
+      node-version: '22'
+      working-directory: docs_with_docusarus
+      upload-artifacts: true
 
-      # Setup pnpm first
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-          run_install: false
-
-      # Then setup Node.js with pnpm cache
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
+  deploy_to_github_pages:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    if: needs.check_docs_changes.outputs.should_deploy == 'true'
+    needs: [check_docs_changes, build_documentation]
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v6
         with:
-          node-version: '22'
-          cache: 'pnpm'
-          cache-dependency-path: docs_with_docusarus/pnpm-lock.yaml
-
-      - name: Install dependencies
-        working-directory: docs_with_docusarus
-        run: pnpm install --no-frozen-lockfile
-
-      - name: Build website
-        working-directory: docs_with_docusarus
-        run: pnpm build
+          name: documentation-build
+          path: ./docs_with_docusarus/build
 
-      # Setup Pages
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
-      # Upload artifact
-      - name: Upload artifact
+      - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v4
         with:
           path: ./docs_with_docusarus/build
 
-      # Deploy to GitHub Pages
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4
+
+      - name: Deployment summary
+        run: |
+          echo "## 📚 Documentation Deployment" >> $GITHUB_STEP_SUMMARY
+          echo "✅ Successfully deployed to GitHub Pages" >> $GITHUB_STEP_SUMMARY
+          echo "🔗 **URL**: ${{ steps.deployment.outputs.page_url }}" >> $GITHUB_STEP_SUMMARY