Build RTD docs from extras (#808)

.github/workflows/docs.yml

@@ -13,16 +13,13 @@ jobs:
       uses: actions/setup-python@v1
       with:
         python-version: 3.9
-    - name: Install MPI
+    - name: Setup software environment
       run: |
         sudo apt update
         sudo apt install -y openmpi-bin libopenmpi-dev
-    - name: Install dependencies
+    - name: Setup Python environment
       run: |
         python -m pip install --upgrade pip
-        pip install -r docs/requirements.txt
-    - name: Install self
-      run: |
-        pip install -e .
-    - name: Fail documentations on warnings
+        pip install -e .[docs]
+    - name: Build documentation, nitpick, and fail on warnings
       run: cd docs && sphinx-build -nW -b html . _build/html

.readthedocs.yml

@@ -13,4 +13,5 @@ python:
   install:
     - method: pip
       path: .
-    - requirements: docs/requirements.txt
+      extra_requirements:
+        - docs

pyproject.toml

@@ -75,7 +75,9 @@ docs = [
     "sphinxemoji~=0.2.0",
     "sphinx_design~=0.5.0",
     "sphinx-copybutton~=0.5.0",
-    "sphinxext-bsb~=0.2.1"
+    "sphinxext-bsb~=0.2.1",
+    "bsb-json>=0.0.0b5",
+    "bsb-yaml>=0.0.0b4",
 ]
 dev = [
     "build~=1.0",