versioned docs in ci

Author: lazyoracle

.github/workflows/ci.yml

@@ -1,8 +1,8 @@
-name: test and deploy docs
+name: deploy docs and publish package
 on:
   push:
-    branches:
-      - main
+    tags:
+      - "*"
 permissions:
   contents: write
 jobs:
@@ -14,11 +14,12 @@ jobs:
         run: |
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+          git fetch origin gh-pages --depth=1
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
           cache: 'pip'
           cache-dependency-path: 'pyproject.toml'
       - run: pip install -e .\[all,docs\]
       - run: pytest -x -vv --cov=src tests/
-      - run: mkdocs gh-deploy --force
+      - run: mike deploy -u -p ${{ github.ref_name }} latest