~Some PRs (e.g. #1046) have problems with the docs because of the old Sphinx version CI is using, the latest available in the defaults channel being 5.0.2. This PR switches to using conda-forge to get later versions, so that features such as :no-index: can be used.~
Update: The new approach in this PR is to remove the docs testing on Azure and enable nitpicky mode in the Sphinx config. Now:
The RTD build is checking the same things as the Azure docs build was
There is no inconsistency between Sphinx versions in docs testing (since RTD is only running one version of Sphinx)
I purposely broke a reference in adf79ff, and then the RTD build failed with nitpicky mode was enabled, demonstrating that this is testing for broken references. I have subsequently reverted / fixed the broken reference in a later commit, and removed the Azure docs testing.
~Some PRs (e.g. #1046) have problems with the docs because of the old Sphinx version CI is using, the latest available in the defaults channel being 5.0.2. This PR switches to using conda-forge to get later versions, so that features such as
:no-index:
can be used.~~From the CI logs:~
Update: The new approach in this PR is to remove the docs testing on Azure and enable nitpicky mode in the Sphinx config. Now:
I purposely broke a reference in adf79ff, and then the RTD build failed with nitpicky mode was enabled, demonstrating that this is testing for broken references. I have subsequently reverted / fixed the broken reference in a later commit, and removed the Azure docs testing.