@felixxm this is causing issues for me when using a Python 3.13 venv. Installing all dependencies from scratch gives this error:

ERROR: Cannot install -r docs/requirements.txt (line 2), docutils>=0.22 and sphinx==8.2.3 because these package versions have conflicting dependencies.

Seems that Sphinx is not ready for docutils 0.22+ yet, see Sphinx changelog:

Release 8.3.0 (in development)
#13786: Support Docutils 0.22. Patch by Adam Turner.

I think we may need to pin docutils to < 0.22 instead, like Sphinx does:

"docutils>=0.20,<0.22",

I see this is caused by installing both the docs/requirements.txt and tests/requirements/py3.txt in the same env, which I usually do for Django development. Are you using two separated envs for docs vs tests? 🤔

I see this is caused by installing both the docs/requirements.txt and tests/requirements/py3.txt in the same env, which I usually do for Django development. Are you using two separated envs for docs vs tests? 🤔

We've bumped requirements for Django (django.contrib.admindocs). I don't think that lack of Sphinx support should block this, but we can wait a bit. Sphinx 8.3.0 will support the newest docutils version.

I see this is caused by installing both the docs/requirements.txt and tests/requirements/py3.txt in the same env, which I usually do for Django development. Are you using two separated envs for docs vs tests? 🤔

We've bumped requirements for Django (django.contrib.admindocs). I don't think that lack of Sphinx support should block this, but we can wait a bit. Sphinx 8.3.0 will support the newest docutils version.

Makes sense, thank you, I'll approve so you can land when you consider it best.