Sphinx cannot be upgraded to latest version because it has Python 3.11 as minimum

We likely shoudl not even attempt to solve it - before 3.11 is the "lowest" version. Dumping the result of the discussion we held in Slack on why 3.10 + CI Image + Sphinx are mostly coupled and what effects it might have if we want to run docs building on 3.11. For example running mypy on 3.10 and 3.11 will 100% produce different results And we are using the very same "default" 3.10 image to run our mypy checks So this is a "reproducibility" feature and "optimization" why all our code and images are by default "floored" to the lowest possible version We might think of doing it differently - but we will have to compromise on "reproducibility" and "optimization" and those two are super important (and my personal priority) taking into account 3600+ contributors we have - making their life harder because we want to upgrade sphinx, is "no-go" for me I mean - surely - if someone comes with a solution that does not compromise those two - super but I was unable to come with one (and I tried) - "reproducibilty" and "optimisation" is top 1 If we find a way how to upgrade sphinx without compromizing those - cool And staying on "default" (i.e. lowest) version of Python for everything that involves Python code and requires CI image, is the best way I found to keep those two. But in the last 4 years I was unable to find such a solution So it's likey it's not worth even spending time on discussing it One of the big problems is space used on local machines. Currently in order to build docs Sphinx is importing a lot of code from providers, and it means that it really has to be run on the system that has all dependencies installed - i.e. inside the CI image. Running it on different architectures and OS-es might simply fail. This is the main reason why "breeze build-docs" uses the image - because of "reproduicibility". And yes -we could build separately "3.11" image for it for every developer - but i am not sure if you noticed but with uv and cache, breeze recently started to use a l…