Open bouweandela opened 9 months ago
I suspect this is causing the build to fail:
/home/docs/checkouts/readthedocs.org/user_builds/esmvaltool/checkouts/stable/doc/sphinx/source/changelog.rst:140: WARNING: undefined label: 'esmvalcore:config-dask'
/home/docs/checkouts/readthedocs.org/user_builds/esmvaltool/checkouts/stable/doc/sphinx/source/changelog.rst:244: WARNING: undefined label: 'esmvalcore:changelog-v2-8-0'
/home/docs/checkouts/readthedocs.org/user_builds/esmvaltool/checkouts/stable/doc/sphinx/source/community/backward_compatibility.rst:246: WARNING: undefined label: 'esmvalcore:changelog'
/home/docs/checkouts/readthedocs.org/user_builds/esmvaltool/checkouts/stable/doc/sphinx/source/community/release_strategy/release_strategy.rst:80: WARNING: undefined label: 'esmvalcore:changelog-v2-9-0'
/home/docs/checkouts/readthedocs.org/user_builds/esmvaltool/checkouts/stable/doc/sphinx/source/community/release_strategy/release_strategy.rst:92: WARNING: undefined label: 'esmvalcore:changelog-v2-8-1'
/home/docs/checkouts/readthedocs.org/user_builds/esmvaltool/checkouts/stable/doc/sphinx/source/community/release_strategy/release_strategy.rst:102: WARNING: undefined label: 'esmvalcore:changelog-v2-8-0'
It looks like viewing older versions of the documentation is not so easy anymore either since we switched to the pydata theme, the box where you could select the version is gone.
Linking between the ESMValCore and ESMValTool documentation also doesn't work properly, e.g. when I go to https://docs.esmvaltool.org/en/v2.11.0/ (the ESMValTool docs) and then click on a page the is part of the ESMValCore subproject, it takes me to https://docs.esmvaltool.org/projects/ESMValCore/en/latest/quickstart/index.html instead of https://docs.esmvaltool.org/projects/ESMValCore/en/v2.11.0/quickstart/index.html.
Maybe we need to change the documentation to two separate projects because this setup is broken and confusing to users.
Added this topic to the agenda of the next @ESMValGroup/technical-lead-development-team meeting
Documentation page: https://docs.esmvaltool.org/en/stable/
Related to https://github.com/ESMValGroup/ESMValCore/issues/1987
Failed build: https://readthedocs.org/projects/esmvaltool/builds/22909173/