s3-school · vuillaut · Jan 28, 2026 · Jan 28, 2026 · Jan 28, 2026 · Jan 28, 2026
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -30,12 +30,12 @@ jobs:
           pixi-version: v0.63.1
 
       - name: Build documentation with Sphinx
-        run: pixi run sphinx-build -b html source build/html
+        run: pixi run -e sphinx-doc sphinx-html
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: "build/html"
+          path: "build_docs"
 
   deploy:
     needs: build

diff --git a/.gitignore b/.gitignore
@@ -78,7 +78,7 @@ instance/
 .scrapy
 
 # Sphinx documentation
-docs/
+build_docs/
 
 # PyBuilder
 .pybuilder/

diff --git a/README.md b/README.md
@@ -93,19 +93,27 @@ pixi shell
 # use development dependencies like jupyter notebooks/ipython
 jupyterlab
 ```
-#### Tests
+
+### Tests
 ```bash
 # Run tests
 pixi run test
 ```
 
-#### Linting
+### Linting
 ```bash
 # Linting
 pixi run lint
 pixi run format
 ```
 
+### Documentation
+```bash
+# Build Sphinx documentation
+pixi run -e sphinx-doc sphinx-html
+# Output will be in build/html/index.html
+```
+
 ## License
 
 MIT License
diff --git a/doc/css/code_select.css b/doc/css/code_select.css
diff --git a/doc/doc_src/configuration.md b/doc/doc_src/configuration.md
diff --git a/doc/doc_src/example_config/example_config.yml b/doc/doc_src/example_config/example_config.yml
diff --git a/doc/doc_src/example_data/coffee_productivity.csv b/doc/doc_src/example_data/coffee_productivity.csv
diff --git a/doc/doc_src/example_script.md b/doc/doc_src/example_script.md
diff --git a/doc/doc_src/index.md b/doc/doc_src/index.md
diff --git a/doc/doc_src/installation.md b/doc/doc_src/installation.md
diff --git a/doc/doc_src/license.md b/doc/doc_src/license.md
diff --git a/doc/doc_src/snippets/example_notebook.ipynb b/doc/doc_src/snippets/example_notebook.ipynb
diff --git a/doc/doc_src/snippets/example_script.py b/doc/doc_src/snippets/example_script.py
diff --git a/doc/doc_src/usage.md b/doc/doc_src/usage.md
diff --git a/doc/images/documentation_logo.svg b/doc/images/documentation_logo.svg