improve docs ci

.github/workflows/ci.yml

@@ -1,29 +1,33 @@
-name: ci 
+name: ci
 on:
   push:
-    branches:
-      - master 
-      - main
+    branches: [main, master]
+
 permissions:
   contents: write
+  pages: write
+
+# Prevent parallel deployments
+concurrency:
+  group: pages-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Configure Git Credentials
-        run: |
-          git config user.name github-actions[bot]
-          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.x
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
-      - uses: actions/cache@v4
-        with:
-          key: mkdocs-material-${{ env.cache_id }}
-          path: .cache
-          restore-keys: |
-            mkdocs-material-
-      - run: pip install mkdocs-material 
-      - run: mkdocs gh-deploy --force
+          python-version: '3.x'
+          cache: 'pip'
+          cache-dependency-path: 'apps/docs/requirements.txt'
+      
+      - name: Install and Deploy
+        working-directory: apps/docs
+        run: |
+          pip install mkdocs-material
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+          mkdocs gh-deploy --force