This PR adds thehttps://sphinx-codeautolink.readthedocs.io/ Sphinx extension to the documentation build process. In their own words, it

makes code examples clickable by inserting links from individual code elements to the corresponding reference documentation

In my opinion, it is quite helpful for documentation readers to be able to immediately jump from e.g. tutorial code usinglogging.getLogger (<-- points to the PR doc build that shows the linking) to its reference description.

A bit of discussion has happened inhttps://discuss.python.org/t/add-the-sphinx-codeautolink-extension-to-doc-build-process/80814, back when the extension was not as robust and featureful as nowadays.
As said there, the styling of these extra links can be as unobtrusive as we want them.

Code examples that are parseable and self-contained (i.e. have all their imports) will have clickable objects.

Examples that are made up of parts that build on each other can also be supported with some extra markup (not part of this PR).
Missing imports can be annotated "invisibly" (not part of this PR).

Also, in the current state of the documentation, not all code examples thatcould be parseable actuallyare.
#133906 would fix a number of these.

Other examples would benefit from using.. code-block:: with an explicit language set instead of:: so that special handling forpycon (clean_pycon) could kick in. Right now, these places are producing a warning that is handled viasuppress_warnings.

Speaking ofsuppress_warnings, it containsconfig.cache because of
WARNING: cannot cache unpickleable configuration value: 'codeautolink_custom_blocks' (because it contains a function, class, or module object) [config.cache], which is indeed set to the functionclean_pycon.

• Issue:Add the sphinx-codeautolink extension to the doc build process? #134895

📚 Documentation preview 📚:https://cpython-previews--134896.org.readthedocs.build/