refactor docs

Author: vincentsarago

.github/workflows/cicd.yaml

@@ -56,10 +56,11 @@ jobs:
           enable-cache: true
 
       - name: Set up Python3
-        run: uv python install 3
+        run: uv python install 3.12
 
-      - name: Test generating docs
-        run: make docs
+      - name: Test docs
+        run: |
+          uvx --with-requirements requirements/requirements-docs.txt mkdocs build --strict -f docs/mkdocs.yml 
 
   benchmark:
     needs: [test]

.github/workflows/deploy_mkdocs.yml

@@ -32,9 +32,6 @@ jobs:
       - name: Install dependencies
         run: |
           uv sync --all-extras
-
-      - name: Install dependencies
-        run: |
           uv run pip install -r requirements/requirements-docs.txt
 
       - name: Deploy docs

requirements/requirements-docs.txt

@@ -3,4 +3,8 @@ mkdocs>=1.4.3
 mkdocs-jupyter>=0.24.5
 mkdocs-material[imaging]>=9.5
 griffe-inherited-docstrings>=1.0.0
-mkdocstrings[python]>=0.25.1
+mkdocstrings[python]>=0.25.1
+
+-e stac_fastapi/types
+-e stac_fastapi/api
+-e stac_fastapi/extensions