Upgrade to Sphinx 9.x
Open
@aryanputta is already working on this.
Since Aug 14, 2026.
documentation
P1
triage
- Dominant language
- Cython
- Stars
- 3.4k
- Forks
- 329
- Avg merge
- 1d 23h
- Merged PRs (30d)
- 116
Description
We currently hold back the version of Sphinx we use to < 8.2.0 which puts us on a release from 2024. Eventually, this will no longer work with new versions of Python.
I am also seeing this hit us because it has drifted from what the Sphinx' documentation currently says about usage, leading to incorrect directive usage (See #2584).
We should upgrade to the latest version of Sphinx and confirm nothing breaks.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.