Merge remote-tracking branch 'origin/develop' into develop

.github/workflows/jekyll-gh-pages.yml

@@ -1,64 +1,45 @@
-# Sample workflow for building and deploying a Jekyll site to GitHub Pages
 name: Docs deploy
 
 on:
-  # Runs on pushes targeting the default branch
   push:
     branches: ["develop"]
-
-  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
   group: "pages"
   cancel-in-progress: false
 
 jobs:
-  # Build job
   build:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout
+      - name: Checkout repository
         uses: actions/checkout@v4
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@086ffb1a2090c870a3f881cc91ea83aa4243d408 # v1.161.0
-        with:
-          ruby-version: '3.1' # Not needed with a .ruby-version file
-          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-          cache-version: 0 # Increment this number if you need to re-download cached gems
 
-      - name: Install Jekyll and Dependencies
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install MkDocs and dependencies
         run: |
           cd docs
-          bundle install
-          bundle exec which jekyll  # Debug: Check if Jekyll is installed
-          
-      - name: Setup Pages
-        id: pages
-        uses: actions/configure-pages@v5
-      - name: Build with Jekyll
-        # Outputs to the './_site' directory by default
-        # Sample workflow for building and deploying a Jekyll site to GitHub Pages
-        run: cd docs && bundle exec jekyll build --destination ../_site
-        env:
-          JEKYLL_ENV: production
+          pip install -r requirements.txt
+      
+      - name: Build MkDocs site
+        run: |
+          mkdocs build --site-dir site
+      
       - name: Upload artifact
-        # Automatically uploads an artifact from the './_site' directory by default
         uses: actions/upload-pages-artifact@v3
         with:
-          path: _site
-
-  # Deployment job
+          path: site
+
   deploy:
     environment:
       name: github-pages