readthedocs build started failing in PRs and complains about wrong sphinx version

[m-albert]

readthedocs started to throw errors Sphinx version error in PRs such as #213 or #344. However, there were no changes to the readthedocs configuration and dependencies are all pinned.

It seems that sphinx 4.5. is being used for the build although version 5.3. is pinned here

dask-image/continuous_integration/environment-doc.yml

Line 10 in d241e7a

- sphinx==5.3.0

What's interesting is that cat continuous_integration/environment-doc.yml on the readthedocs shows something different than continuous_integration/environment-doc.yml in the repository. Namely, there's a conda dependency sphinx added at the end, as if readthedocs added lines in the background.

I posted a question on stackoverflow regarding this.

[jakirkham]

Looked at this for a bit, but couldn't figure out what was going on either

If I had to guess, a different Python environment is being used, which isn't the one we created

Would suggest raising an issue upstream. They should be able to advise on any next steps (like config updates) that we need to take

[m-albert]

Thanks John 🙏

I created an issue upstream as you suggested.

Yeah it seems to use a different environment. I wonder whether it could be related to the fact that there's an additional conda sphinx dependency shown in the RTD print of the used env file.

[jakirkham]

Thank Marvin! 🙏

Yeah let's see what they say

Sounds plausible

[GenevieveBuckley]

Closing this issue now #354 is merged.

There is still some follow up work planned (removing the sphinx dependencies pinned in #354 when sphinx v5 is consistently being installed in the test environment. If needed, we can open a new issue to track this follow up.