Skip to content

chore: restore compatible Read the Docs dependencies - #306

Merged
dbrattli merged 2 commits into
mainfrom
fix/readthedocs-sphinx-dependencies
Nov 12, 2026
Merged

dbrattli merged 2 commits into
mainfrom
fix/readthedocs-sphinx-dependencies

Conversation

@dbrattli

@dbrattli dbrattli commented Nov 12, 2026 •

Copy link
Copy Markdown
Owner

Read the Docs fails because the site still uses Jupyter Book's Sphinx configuration, while Jupyter Book 2 replaced that backend with MyST and no longer supplies the required Sphinx extensions.

Constrain Jupyter Book to >=1.0.4,<2.0 and let it select compatible Sphinx and extension dependencies. Keep Jupytext for the Python notebook sources and remove redundant, conflicting, and unused requirements.

Configure Dependabot to ignore Jupyter Book versions >=2.0, retaining 1.x updates until the documentation is explicitly migrated.

Verification: the complete HTML build with notebook execution succeeds on Python 3.13 using python -m sphinx -T -b html -d /tmp/expression-docs-build/doctrees -D language=en . /tmp/expression-docs-build/html from docs/; .venv/bin/python -m pytest passes all 657 tests. Parsed the Dependabot YAML and checked that its ignored version range excludes 1.x and includes 2.x and later.

@dbrattli dbrattli changed the title fix: restore compatible Read the Docs dependencies chore: restore compatible Read the Docs dependencies Nov 12, 2026
@dbrattli
dbrattli merged commit 15e8433 into main Nov 12, 2026
8 checks passed
@dbrattli
dbrattli deleted the fix/readthedocs-sphinx-dependencies branch November 12, 2026 02:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant