OpenSourceEconomics · hmgaudecker · Jan 16, 2026 · Jan 16, 2026 · Jan 16, 2026 · Jan 16, 2026
diff --git a/.gitignore b/.gitignore
@@ -137,4 +137,7 @@ venv.bak/
 
 
 src/dags/_version.py
-docs/source/_build/
+docs/_build/
+
+# MyST build outputs
+_build
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -1,16 +1,20 @@
 ---
 version: 2
 build:
-  os: ubuntu-lts-latest
+  os: ubuntu-24.04
   tools:
     python: '3.13'
+    nodejs: '20'
   jobs:
     create_environment:
       - asdf plugin add pixi
       - asdf install pixi latest
       - asdf global pixi latest
     install:
       - pixi install -e docs
-    build:
-      html:
-        - pixi run -e docs sphinx-build -T -b html docs/source $READTHEDOCS_OUTPUT/html
+    post_build:
+      # Jupyter Book 2.0 builds site content to _build/html.
+      # For ReadTheDocs, we build and then copy to the expected output location.
+      - mkdir --parents $READTHEDOCS_OUTPUT/html/
+      - BASE_URL="/$READTHEDOCS_LANGUAGE/$READTHEDOCS_VERSION" pixi run -e docs docs
+      - cp -a docs/_build/html/. "$READTHEDOCS_OUTPUT/html" && rm -r docs/_build
diff --git a/binder/requirements.txt b/binder/requirements.txt
@@ -0,0 +1,2 @@
+dags
+numpy
diff --git a/docs/Makefile b/docs/Makefile
diff --git a/docs/source/_static/css/custom.css → docs/_static/css/custom.css b/docs/source/_static/css/custom.css → docs/_static/css/custom.css
diff --git a/docs/source/_static/images/logo.svg → docs/_static/images/logo.svg b/docs/source/_static/images/logo.svg → docs/_static/images/logo.svg
diff --git a/docs/source/example/__init__.py → docs/example/__init__.py b/docs/source/example/__init__.py → docs/example/__init__.py
diff --git a/docs/source/example/example.ipynb → docs/example/example.ipynb b/docs/source/example/example.ipynb → docs/example/example.ipynb
diff --git a/docs/source/example/linear.py → docs/example/linear.py b/docs/source/example/linear.py → docs/example/linear.py
diff --git a/docs/source/example/parabolic.py → docs/example/parabolic.py b/docs/source/example/parabolic.py → docs/example/parabolic.py
diff --git a/docs/source/getting_started.md → docs/getting_started.md b/docs/source/getting_started.md → docs/getting_started.md
@@ -18,7 +18,7 @@ def y(x):  # depends on x because parameter is named "x"
 
 ### Creating a Combined Function
 
-The main entry point is {func}`~dags.concatenate_functions`:
+The main entry point is `concatenate_functions`:
 
 ```python
 import dags
@@ -91,7 +91,7 @@ result = combined()  # {"a": ..., "b": ..., "c": ...}
 
 ## Inspecting the DAG
 
-Use {func}`~dags.create_dag` to create and inspect the dependency graph:
+Use `create_dag` to create and inspect the dependency graph:
 
 ```python
 import dags
@@ -108,7 +108,7 @@ print(list(dag.edges()))  # [('income', 'tax'), ('tax', 'net_income'), ...]
 
 ## Finding Dependencies
 
-Use {func}`~dags.get_ancestors` to find all functions that a target depends on:
+Use `get_ancestors` to find all functions that a target depends on:
 
 ```python
 ancestors = dags.get_ancestors(
@@ -122,7 +122,7 @@ ancestors = dags.get_ancestors(
 
 ### Getting Function Arguments
 
-{func}`~dags.get_free_arguments` returns the parameter names of a function:
+`get_free_arguments` returns the parameter names of a function:
 
 ```python
 def my_func(a, b, c=1):
@@ -134,7 +134,7 @@ args = dags.get_free_arguments(my_func)
 
 ### Getting Type Annotations
 
-{func}`~dags.get_annotations` returns type annotations:
+`get_annotations` returns type annotations:
 
 ```python
 def my_func(a: int, b: float) -> float:
@@ -146,7 +146,7 @@ annotations = dags.get_annotations(my_func)
 
 ## Renaming Arguments
 
-Use {func}`~dags.rename_arguments` to change parameter names:
+Use `rename_arguments` to change parameter names:
 
 ```python
 def original(x, y):
@@ -162,4 +162,3 @@ This is useful when integrating functions from different sources that use differ
 
 - Learn about [common usage patterns](usage_patterns.md) from real projects
 - Explore [tree structures](tree.md) for nested data
-- See the complete [API reference](api.md)
diff --git a/docs/source/index.md → docs/index.md b/docs/source/index.md → docs/index.md
@@ -1,7 +1,7 @@
 # dags
 
 ```{image} _static/images/logo.svg
-:width: 400
+:width: 400px
 :align: center
 ```
 
@@ -56,14 +56,3 @@ Or with conda:
 ```bash
 conda install -c conda-forge dags
 ```
-
-## Table of Contents
-
-```{toctree}
-:maxdepth: 2
-
-getting_started
-usage_patterns
-tree
-api
-```
diff --git a/docs/make.bat b/docs/make.bat
diff --git a/docs/myst.yml b/docs/myst.yml
@@ -0,0 +1,32 @@
+---
+# Jupyter Book 2.0 configuration
+# See: https://jupyterbook.org/
+version: 1
+project:
+  id: dags
+  title: dags
+  description: >-
+    Tools to create executable DAGs from interdependent functions.
+  authors:
+    - name: Janos Gabler
+      email: [email protected]
+    - name: Tobias Raabe
+  keywords:
+    - dag
+    - directed acyclic graph
+    - functions
+    - python
+  github: https://github.com/OpenSourceEconomics/dags
+  jupyter: true
+  toc:
+    - file: index.md
+    - file: getting_started.md
+    - file: usage_patterns.ipynb
+    - file: tree.md
+  error_rules:
+    - rule: link-resolves
+      severity: ignore
+site:
+  template: book-theme
+  options:
+    logo_text: dags
diff --git a/docs/source/api.md b/docs/source/api.md