fix: manage docs deps with poetry

.github/workflows/docs.yml

@@ -24,15 +24,19 @@ jobs:
       uses: actions/setup-python@v5
       with:
         python-version: '3.12'
-    - name: Install mkdocs
-      run: python -m pip install mkdocs "mkdocstrings[python]" mkdocs-material
-    - name: Setup caching
+    - name: Install poetry
+      run: python -m pip install poetry
+    - name: Configure poetry
+      run: poetry config virtualenvs.in-project true
+    - name: Cache the virtualenv
       uses: actions/cache@v4
       with:
-        key: ${{ github.sha }}
-        path: .cache
+        path: ./.venv
+        key: ${{ runner.os }}-venv-${{ hashFiles('**/poetry.lock') }}
+    - name: Install dependencies
+      run: poetry install --with docs --without dev
     - name: Build site
-      run: mkdocs build
+      run: poetry run mkdocs build
     - name: Upload artifact
       uses: actions/upload-pages-artifact@v3
       with:

.github/workflows/tests.yml

@@ -10,7 +10,8 @@ jobs:
   tests:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - name: Checkout
+      uses: actions/checkout@v4
     - name: Setup python
       uses: actions/setup-python@v5
       with:
@@ -25,7 +26,7 @@ jobs:
         path: ./.venv
         key: ${{ runner.os }}-venv-${{ hashFiles('**/poetry.lock') }}
     - name: Install dependencies
-      run: poetry install
+      run: poetry install --without docs
     - name: Lint
       run: poetry run ruff check --show-files --exit-non-zero-on-fix
     - name: Run tests