remove docs-deploy from publish.yml and create a separate docs.yml that triggers on push to main

Author: TejasMorbagal

.github/workflows/docs.yml

@@ -0,0 +1,28 @@
+name: Deploy MkDocs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  docs-deploy:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.x'
+
+    - name: Install docs dependencies
+      run: pip install mkdocs-material pymdown-extensions
+
+    - name: Deploy docs
+      run: mkdocs gh-deploy --force

.github/workflows/publish.yml

@@ -63,24 +63,3 @@ jobs:
         user: __token__
         password: ${{ secrets.PYPI_API_TOKEN }}
         verbose: true
-
-  docs-deploy:
-    name: Deploy MkDocs to GitHub Pages
-    runs-on: ubuntu-latest
-    needs: unittest
-    permissions:
-      contents: write
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.x'
-
-    - name: Install docs dependencies
-      run: pip install mkdocs-material pymdown-extensions
-
-    - name: Deploy docs
-      run: mkdocs gh-deploy --force