-
-
Notifications
You must be signed in to change notification settings - Fork 950
Description
Read the Docs has various addons, most or all of which look useful and appropriate for GitPython's documentation on Read the Docs, that can be enabled.
This feature is to some extent an increase in RTD-specific functionality. But it also, if I understand correctly, moves the RTD-specific changes out of the build process, so that RTD and non-RTD (e.g. local) builds are more similar.
The instructions for enabling add-ons explicitly mention that they will be enabled automatically for all projects "some time in the second half of 2024." But examining the classic dashboard for a preview build reveals that this will happen in about three weeks from now, which the official blog post confirms.
I recommend explicitly enabling addons and selecting any that are desired, which I suspect will be all or most of them, in order to identify any problems before that time, thereby avoiding disruption. Any problems related to the overall change itself or to specific addons that are wanted can thus be solved before then, while any addons that are not wanted at all can be turned off.
(One of the addons that I think may be prove especially useful is DocDiff, which is part of pull request previews. I believe this does not require any further integration than is currently done, because it's a change to the previews themselves.)
It does not look like this feature can be enabled by alternative means such as editing the .readthedocs.yml
file, which is why I'm opening this issue about it rather than a PR.