fix(ci): migrate deploy-docs workflow from Jekyll to Docusaurus

- Replace Ruby/Jekyll setup with Node.js/Docusaurus
- Match deployment configuration with release.yml workflow
- Remove Jekyll-specific steps (Ruby setup, bundler cache)
- Add Docusaurus build steps (API docs generation, build)
- Fixes pipeline reverting to Jekyll instead of deploying Docusaurus

This ensures consistent deployment across all workflows

Author: tosin2013

.github/workflows/deploy-docs.yml

@@ -1,4 +1,4 @@
-name: Deploy Jekyll to GitHub Pages
+name: Deploy Docusaurus to GitHub Pages
 
 on:
   push:
@@ -17,29 +17,45 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: docs
     steps:
-      - name: Checkout
+      - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
-          ruby-version: '3.1'
-          bundler-cache: true
-          working-directory: docs
+          node-version: "20.x"
+          cache: "npm"
 
-      - name: Build with Jekyll
-        run: npm run build
+      - name: Install root dependencies
+        run: npm ci
+
+      - name: Generate API documentation
+        run: npm run docs:generate
+
+      - name: Remove problematic media directory
+        run: rm -rf docs/api/media
+
+      - name: Install Docusaurus dependencies
+        run: cd docs && npm ci
+
+      - name: Copy API documentation to build directory
+        run: |
+          mkdir -p docs/build/api
+          cp -r docs/api/* docs/build/api/
+
+      - name: Build Docusaurus site
+        run: cd docs && npm run build
         env:
-          JEKYLL_ENV: production
+          NODE_ENV: production
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v4
         with:
-          path: docs/./_site
+          path: ./docs/build
 
   deploy:
     environment:
@@ -50,4 +66,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4