Fix docs dependency metadata for PyPI

.github/PULL_REQUEST_TEMPLATE.md

@@ -84,6 +84,6 @@ mypy .
 pytest
 
 # Build docs
-pip install -e .[docs] && make -C docs html
+pip install -r requirements-docs.txt && make -C docs html
 
 -->

.github/workflows/docs.yml

@@ -34,13 +34,14 @@ jobs:
           sudo rm -rf /var/lib/apt/lists/*
 
       - name: Install documentation dependencies
+        working-directory: docs
         run: |
           df -h
           python -m pip install --upgrade pip
           df -h
           pip install --index-url https://download.pytorch.org/whl/cpu "torch>=2.0.0,<=2.10.0"
           df -h
-          pip install -e ".[docs]"
+          pip install -r requirements.txt
           df -h
 
       - name: Build documentation

README.md

@@ -52,7 +52,7 @@ pip install -e '.[examples]'
 
 Build documentation locally:
 ```bash
-pip install -e '.[docs]'
+pip install -r requirements-docs.txt
 cd docs
 make html  # or: make livehtml (if sphinx-autobuild added manually)
 ```

docs/requirements.txt

@@ -1 +1,2 @@
 -e ..[docs]
+-r ../requirements-docs-vcs.txt

pyproject.toml

@@ -58,7 +58,6 @@ docs = [
     "ipykernel",
     "gitpython",
     "python-dotenv",
-    "sphinx-multiversion-contrib @ git+https://github.com/Quandela/sphinx-multiversion-contrib.git@1.1.1",
     "jinja2==3.0.0",
     "scikit-learn>=1.7.0",
 ]

requirements-docs-vcs.txt

@@ -0,0 +1 @@
+sphinx-multiversion-contrib @ git+https://github.com/Quandela/sphinx-multiversion-contrib.git@1.1.1

requirements-docs.txt

@@ -1 +1,2 @@
 -e .[docs]
+-r requirements-docs-vcs.txt