diff --git a/docs/conf.py b/docs/conf.py index cbb9ee44..cf4e8159 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -36,8 +36,17 @@ # ones. extensions = [ "sphinx.ext.autodoc", + "sphinx.ext.intersphinx", ] +# Resolve references to the standard library and other projects, so that +# annotations such as collections.abc.Mapping or datetime.datetime link to +# their documentation instead of producing "reference target not found" +# warnings under `sphinx-build -n`. +intersphinx_mapping = { + "python": ("https://docs.python.org/3", None), +} + # Add any paths that contain templates here, relative to this directory. templates_path = ["_templates"]