diff --git a/docs/Makefile b/docs/Makefile index 6e35eea2..d9ed9c70 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -19,6 +19,9 @@ ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . +# See https://www.sphinx-doc.org/en/master/man/sphinx-build.html?highlight=--keep-going#cmdoption-sphinx-build-W +WARNING_TO_ERROR = -W --keep-going + .PHONY: help help: @echo "Please use \`make ' where is one of" @@ -55,7 +58,7 @@ clean: .PHONY: html html: - $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html + $(SPHINXBUILD) $(WARNING_TO_ERROR) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." diff --git a/docs/conf.py b/docs/conf.py index d70991db..395a8ff9 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -303,6 +303,6 @@ # Example configuration for intersphinx: refer to the Python standard library. intersphinx_mapping = { - "python": ("https://docs.python.org/", None), + "python": ("https://docs.python.org/3/", None), "iris": ("https://scitools-iris.readthedocs.io/en/stable/", None), } diff --git a/docs/ref/release_notes.rst b/docs/ref/release_notes.rst index 9ab84444..d69a620c 100644 --- a/docs/ref/release_notes.rst +++ b/docs/ref/release_notes.rst @@ -1,3 +1,5 @@ +:orphan: + .. _release_notes: Release Notes