fix publish job to use trusted publishers

.github/workflows/release.yml

@@ -8,17 +8,22 @@ on:
     types: [released]
 
 jobs:
-  deploy:
+  pypi-publish:
+    name: upload release to PyPI
     runs-on: ubuntu-latest
     environment: release
+    permissions:
+      id-token: write
     steps:
-    - uses: actions/checkout@v3
+      - uses: actions/checkout@v3
 
-    - name: Set up Python
-      uses: wntrblm/[email protected]
-      with:
-        python-versions: '3.11'
-    - name: Build dist
-      run: nox -s build
-    - name: Publish dist
-      run: nox -s publish
+      - name: Set up Python
+        uses: wntrblm/[email protected]
+        with:
+          python-versions: '3.11'
+
+      - name: Build dist
+        run: nox -s build
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

mkdocs.yml

@@ -43,6 +43,10 @@ theme:
 
 extra_css: [extra.css]
 
+extra:
+  version:
+    provider: mike
+
 markdown_extensions:
   - admonition
   - attr_list
@@ -85,6 +89,7 @@ plugins:
   - literate-nav:
       nav_file: SUMMARY.md
   - section-index
+  - mike
   - mkdocstrings:
       handlers:
         python: