Documentation no longer updates automatically

[zorun]

It says "Failed" on https://readthedocs.org/projects/ihatemoney/builds/

This happened before in #653

Maybe we should update documentation from the Github CI, so that we would be aware when it breaks.

[zorun]

Still not working, different issue: https://readthedocs.org/projects/ihatemoney/builds/21301509/

@Glandos apparently the sphinx-rtd-theme from readthedocs does not support Sphinx 7:

• Project fails to build with Sphinx 7.0.0 (jinja2.exceptions.UndefinedError: 'style' is undefined) readthedocs/readthedocs.org#10279
• Add Sphinx 7 support readthedocs/sphinx_rtd_theme#1463

I see you updated Sphinx #1172 because of docutils, why do we need a newer docutils?

[zorun]

To be honest (it's definitely not against you @Glandos ), I'm really fed up with dependabot trying to update everything to the latest version, even if we don't actually need it... (e.g. not for security issues)

But maybe that's just me being conservative :D

[Glandos]

I think I should also refrain from clicking on "Update" each time I am notified of something just to have a dopamine shot.

I think that:

• updating "real project" dependencies is good. E.g. SQLAlchemy, Flask, etc.
• updating "dev" dependencies should be done more peacefully. Breaking the build process is easy, fixing it is tedious, and we don't spend enough time on this project for that.

For this specific issue, I am bit hesitant. We can downgrade Sphinx/docutils after all, it won't impact any users. It seems that waiting for a new release of sphinx_rtd_theme is like waiting for the rain in the hot summer of Spain: it will happen, you don't know when.

[zorun]

Totally agree on saving our time, we don't have enough to spend on tedious/pointless fixes :)

If updating sphinx and docutils has no added value, I'm all for downgrading to older versions that work with readthedocs. After all, that's why we pin versions.

[almet]

Hi folks! I agree with you both on that. Regarding the autoupdate of readthedocs. It used to be configured directly on readthedocs, with a hook that happened when we tagged a new version.

It's been a while, so maybe it's not working anymore, though. Maybe nowadays it's better to use the CI for this? Not sure, do you do this on others projects?

[zorun]

@Glandos do you have time to downgrade Sphinx to fix this issue?