Refactor Workflows

.github/workflows/deploy-docs.yml

@@ -4,16 +4,36 @@ on:
   push:
     branches:
       - main
-    paths:
-      - 'docs/**'
-      - 'mkdocs.yml'
 
 permissions:
   contents: write
 
 jobs:
-  deploy:
+  check-for-docs-changes:
+    name: Check for Docs Changes
     runs-on: ubuntu-latest
+    outputs:
+      # Output a boolean indicating if any relevant files have changed
+      docs_changed: ${{ steps.check_files.outputs.any_changed }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check for changed files in docs folder or mkdocs.yml
+        id: check_files
+        uses: tj-actions/changed-files@v40
+        with:
+          files: |
+            docs/**
+            mkdocs.yml
+
+  deploy:
+    name: Deploy MkDocs Site
+    runs-on: ubuntu-latest
+    needs: check-for-docs-changes
+    if: needs.check-for-docs-changes.outputs.docs_changed == 'true'
 
     steps:
       - name: Checkout Code
@@ -29,3 +49,5 @@ jobs:
 
       - name: Deploy Docs to GitHub Pages
         run: mkdocs gh-deploy --force --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}