fix(docs): track empty overrides dir with .gitkeep; add feat/doc-site-update to CI trigger; skip Pages deploy on feature branches

Author: ekizito96

.github/workflows/docs.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+      - feat/doc-site-update
     paths:
       - 'docs/**'
       - 'mkdocs.yml'
@@ -39,11 +40,15 @@ jobs:
         run: mkdocs build --clean
 
       - name: Upload Pages artifact
+        # Only upload artifact when on main (Pages deploy only runs from main)
+        if: github.ref == 'refs/heads/main'
         uses: actions/upload-pages-artifact@v3
         with:
           path: site/
 
   deploy:
+    # Only deploy to GitHub Pages from main
+    if: github.ref == 'refs/heads/main'
     needs: build
     runs-on: ubuntu-latest
     environment: