Improved and simplified documentation gh action

Author: amitdugar

.github/workflows/api-docs.yml

@@ -7,51 +7,50 @@ on:
       - master
     paths:
       - 'docs/**'
+      - 'mkdocs.yml'
       - '.github/workflows/api-docs.yml'
   workflow_dispatch:
 
 permissions:
-  contents: read
   pages: write
   id-token: write
 
 concurrency:
   group: pages
-  cancel-in-progress: true
+  cancel-in-progress: false
 
 jobs:
-  deploy:
-    name: Deploy to GitHub Pages
+  build:
+    name: Build Documentation
     runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1
+      - name: Set up Python
+        uses: actions/setup-python@v5
         with:
-          ruby-version: '3.3'
-          bundler-cache: true
-          working-directory: docs
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: pip install mkdocs-material
 
-      - name: Build site with Jekyll
-        run: bundle exec jekyll build --source docs --destination _site
-        env:
-          JEKYLL_ENV: production
+      - name: Build site
+        run: mkdocs build --strict
 
-      - name: Upload Pages artifact
+      - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
 
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4
-
-      - name: Summary
-        run: |
-          echo "## Docs Deployed" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          PAGE_URL="${{ steps.deployment.outputs.page_url }}"
-          echo "Documentation deployed to: $PAGE_URL" >> $GITHUB_STEP_SUMMARY

docs/ARCHITECTURE.md

@@ -1,8 +1,3 @@
----
-layout: default
-title: Architecture
----
-
 # Architecture
 
 This codebase is a legacy PHP application that has been partially modernized with Slim 4

docs/Gemfile

@@ -1,8 +1,3 @@
----
-layout: default
-title: Backing up to Google Drive with Rclone on Ubuntu
----
-
 # Backing up to Google Drive with Rclone on Ubuntu
 
 ## 1. Install Rclone

docs/_config.yml

@@ -1,8 +1,3 @@
----
-layout: default
-title: Backing up LIS or STS to a Remote Backup Server
----
-
 # Backing up LIS or STS to a Remote Backup Server
 
 ## Step 1: Download the Script

docs/guides/backing-up-to-google-drive-with-rclone.md

@@ -1,8 +1,3 @@
----
-layout: default
-title: Fix Illegal/Mismatched Collation Issue
----
-
 # Fix Illegal/Mismatched Collation Issue
 
 This guide provides steps to resolve collation mismatches in the VLSM database using phpMyAdmin by standardizing all tables and columns to use `utf8mb4_general_ci` collation.

docs/guides/backing-up-to-remote-server.md

@@ -1,8 +1,3 @@
----
-layout: default
-title: Installing InteLIS on Ubuntu 22.04 or above (only Ubuntu LTS)
----
-
 # Installing InteLIS on Ubuntu 22.04 or above (only Ubuntu LTS)
 
 **Important:** This installation works exclusively on Ubuntu 22.04 or later LTS versions.

docs/guides/fix-collation-issue.md

@@ -1,8 +1,3 @@
----
-layout: default
-title: Installing VLSM on a Windows Machine
----
-
 # Installing VLSM on a Windows Machine
 
 ## 0. Download

docs/guides/installing-intelis-on-ubuntu.md

@@ -1,8 +1,3 @@
----
-layout: default
-title: Migrating From One Ubuntu Machine to Another
----
-
 # Migrating From One Ubuntu Machine to Another
 
 ## Backup Database on Old System