From 11cb07271fe6c7aa273a74232ae096dcb3668ef6 Mon Sep 17 00:00:00 2001
From: Tom Vander Aa <tom.vanderaa@gmail.com>
Date: Fri, 16 Jan 2026 15:38:39 +0100
Subject: [PATCH 1/4] ci: readthedocs workflow

---
 .github/workflows/docs.yml | 53 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 .github/workflows/docs.yml

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 00000000..19144ec2
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,53 @@
+name: Build Documentation
+
+on:
+  push:
+    branches:
+    - master
+    - release-*
+    - v*
+  pull_request:
+    branches:
+    - master
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r docs/requirements.txt
+
+    - name: Build documentation
+      run: |
+        cd docs
+        make html
+
+    - name: Check for build errors
+      run: |
+        if [ -d docs/_build/html ]; then
+          echo "Documentation built successfully"
+          ls -la docs/_build/html
+        else
+          echo "Documentation build failed"
+          exit 1
+        fi
+
+    - name: Upload documentation artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: documentation-html
+        path: docs/_build/html/
+        retention-days: 30

From 8f048c05a910d9c6ea76b09a5c2a319ac2b48e22 Mon Sep 17 00:00:00 2001
From: Tom Vander Aa <vanderaa@imec.be>
Date: Tue, 20 Jan 2026 09:36:12 +0100
Subject: [PATCH 2/4] docs: readthedocs now requires build os config

---
 readthedocs.yaml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/readthedocs.yaml b/readthedocs.yaml
index 21a38194..41f71059 100644
--- a/readthedocs.yaml
+++ b/readthedocs.yaml
@@ -5,6 +5,12 @@
 # Required
 version: 2
 
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/conf.py
@@ -19,6 +25,5 @@ formats:
 
 # Optionally set the version of Python and requirements required to build your docs
 python:
-  version: 3.7
   install:
-    - requirements: docs/requirements.txt
\ No newline at end of file
+    - requirements: docs/requirements.txt

From ddad6d0453c828693431c74573b67281cab1e810 Mon Sep 17 00:00:00 2001
From: Tom Vander Aa <vanderaa@imec.be>
Date: Tue, 20 Jan 2026 09:36:29 +0100
Subject: [PATCH 3/4] docs ci: add pandoc

---
 .github/workflows/docs.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 19144ec2..9e75ee07 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -25,6 +25,11 @@ jobs:
       with:
         python-version: '3.11'
 
+    - name: Install pandoc
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y pandoc
+
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip

From 22f86932fe1fbf14fb5b191ad4a8282cb3141719 Mon Sep 17 00:00:00 2001
From: Tom Vander Aa <vanderaa@imec.be>
Date: Tue, 20 Jan 2026 09:36:41 +0100
Subject: [PATCH 4/4] docs: build for smurff v1.0

---
 docs/requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index 99f7f5bb..8d232ac4 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -4,4 +4,4 @@ sphinx_rtd_theme
 ipykernel
 nbsphinx
 pygments>=2.6.1
-smurff>=0.17.0<0.18.0
+smurff==1.0