docs: Use intersphinx_registry to keep intersphinx urls up to date

[Carreau]

I think one of the difference is it will point toward uproot stable instead of latest (which is the dev version).

Checklist Before Requesting Reviewer

• Tests are passing
• "WIP" removed from the title of the pull request
• Selected an Assignee for the PR to be responsible for the log summary

Before Merging

For the PR Assignees:

• Summarize commit messages into a comprehensive review of the PR

[Carreau]

I think that will be of interest for @matthewfeickert from our discussion in Quansight-Labs/intersphinx_registry#42

[matthewfeickert]

Many thanks, @Carreau! I'll need to review this more in the morning (my time) but I think we'll also need to add intersphinx-registry as a dependency to the docs extra

pyhf/pyproject.toml

Lines 116 to 130 in 1f1adc7

	docs = [
	"pyhf[xmlio,contrib]",
	"sphinx>=7.0.0", # c.f. https://github.com/scikit-hep/pyhf/pull/2271
	"sphinxcontrib-bibtex>=2.1",
	"sphinx-click",
	"pydata-sphinx-theme>=0.15.3",
	"nbsphinx!=0.8.8", # c.f. https://github.com/spatialaudio/nbsphinx/issues/620
	"ipywidgets",
	"sphinx-issues",
	"sphinx-copybutton>=0.3.2,!=0.5.1",
	"jupyterlite-sphinx>=0.13.1", # c.f. https://github.com/scikit-hep/pyhf/pull/2458
	"jupyterlite-pyodide-kernel>=0.0.7",
	"jupytext>=1.14.0",
	"ipython!=8.7.0", # c.f. https://github.com/scikit-hep/pyhf/pull/2068
	]

(Also, the non-docs CI will fail, but that's because I've been too swamped to fix things that I know are erroring given PyTorch.)

[Carreau]

No hurry I'm in a train just catching up on stuff; and it's not urgent; has few risks to conflict and easy to redo if needs be.

I think we'll also need to add intersphinx-registry as a dependency to the docs extra

That should already be there:

--- a/pyproject.toml
+++ b/pyproject.toml
@@ -121,6 +121,7 @@ docs = [
     "pydata-sphinx-theme>=0.15.3",
     "nbsphinx!=0.8.8",  # c.f. https://github.com/spatialaudio/nbsphinx/issues/620
     "ipywidgets",
+    "intersphinx_registry",
     "sphinx-issues",
     "sphinx-copybutton>=0.3.2,!=0.5.1",
     "jupyterlite-sphinx>=0.13.1",  # c.f. https://github.com/scikit-hep/pyhf/pull/2458

Also : who does not sort their extras !