Test with docutils 0.18.1

[jarrodmillman]

NOT INTENDED FOR MERGING

There is a bug using 0.18.1 with numpydoc:
numpy/numpydoc#402

I wanted to see if this project was also having issue and noticed that

pip install --upgrade --pre sphinx jinja2

only upgrades sphinx, jinja2 was already 3.1.2, and docutils stays at 0.17.1. So I created this PR to manually test.

On numpdoc, I run into the issue when doing this:

pip install --pre -r requirements/test.txt -r doc/requirements.txt

I don't think we should merge this PR, but maybe we should consider adding a similar test (i.e., testing against all prereleases of the requirements).

[choldgraf]

What's the reason to explicitly test docutils versions? I believe that Sphinx pins the docutils version already.

[drammock]

What's the reason to explicitly test docutils versions? I believe that Sphinx pins the docutils version already.

I think because sphinx v5 uses docutils 18.1? (At least in our CIs that are using the sphinx 5 prerelease, that's the docutils version that gets pulled in)

[choldgraf]

But if we're testing on the pre-release of sphinx wouldn't that also pull in the latest supported docutils?

[jarrodmillman]

Sorry, I should have added a note about this PR (I just added it now).

[jarrodmillman]

I am closing this. I opened another PR where we can discuss testing on prereleases (and upgraded versions of software) #683.

[choldgraf]

Ahhh that indeed makes a lot of sense, I didn't realize that we wouldn't pull in the latest docutils w our current setup. Will take conversation to the other PR