chore: code review

Author: jgravois

.github/workflows/mkdocs.yml

@@ -81,13 +81,21 @@ jobs:
     runs-on: ubuntu-latest
     # don't publish for pull requests
     if: github.event.pull_request == null
-    name: Publish docs
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Deploy docs
-        uses: mhausenblas/mkdocs-deploy-gh-pages@master
-        env:
-          REQUIREMENTS: docs/requirements.txt
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/setup-python@v6
+        with:
+          python-version-file: .github/workflows/.python-version
+          cache: pip
+          cache-dependency-path: |
+            "docs/requirements.txt"
+
+      - name: Install MkDocs requirements
+        run: |
+          pip install -r docs/requirements.txt
+
+      - name: Deploy MkDocs website
+        run: |
+          mkdocs gh-deploy --force