Fix CI/CD dependency conflicts and workflow issues

Author: micahgallen

.github/workflows/docs.yml

@@ -22,12 +22,20 @@ jobs:
         with:
           python-version: 3.9
 
-      - name: Build
+      - name: Install system dependencies
         run: |
-          pip install --upgrade pip
-          pip install psychopy==2020.1.2
+          sudo apt-get update
+          sudo apt-get install -y graphviz
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install --upgrade setuptools wheel
+          pip install -r requirements.txt
           pip install -r requirements-docs.txt
-          sudo apt-get install graphviz
+
+      - name: Build documentation
+        run: |
           sphinx-build -b html docs/source docs/build/html
 
       - name: Deploy 🚀

requirements-docs.txt

@@ -1,15 +1,25 @@
+# Core package
 -e .
-xarray>=2022.6.0
-pymc>=5.0.1
-pydata-sphinx-theme>=0.12.0
+
+# Documentation dependencies
+sphinx==5.3.0
 sphinx-bootstrap-theme>=0.8.1
 sphinxcontrib-bibtex>=2.4.2
-myst-nb>=0.16.0
-sphinx==5.3.0
 numpydoc>=1.4.0
 myst-parser
-#pingouin
+myst-nb>=0.16.0
+
+# Theme
+pydata-sphinx-theme>=0.12.0
+
+# Data analysis (compatible versions)
+xarray>=2022.6.0
 bokeh==2.4.3
+
+# Visualization
 graphviz
-metadpy>=0.0.1
-watermark
+
+# Optional: Commented out to avoid conflicts
+# pymc>=5.0.1
+# metadpy>=0.0.1
+# watermark