diff --git a/peps/pep-0012.rst b/peps/pep-0012.rst index 9ca94ed23..cb52ba430 100644 --- a/peps/pep-0012.rst +++ b/peps/pep-0012.rst @@ -647,8 +647,27 @@ If you find that you need to use a backslash in your text, consider using inline literals or a literal block instead. -Canonical Documentation and Intersphinx ---------------------------------------- +Intersphinx +----------- + +You can use +`Intersphinx references +`_ +to other Sphinx sites, +such as the `Python documentation `_ +`packaging.python.org `_, +and `typing.readthedocs.io `_, +to easily cross-reference pages, sections and Python/C objects. + +For example, +to create a link pointing to a section of the typing docs, +you would write the following:: + + :ref:`type expression ` + + +Canonical Documentation +----------------------- As :pep:`PEP 1 describes <1#pep-maintenance>`, PEPs are considered historical documents once marked Final, @@ -659,15 +678,6 @@ or an appropriate subclass: * ``canonical-pypa-spec`` for packaging standards * ``canonical-typing-spec`` for typing standards -Furthermore, you can use -`Intersphinx references -`_ -to other Sphinx sites, -currently the `Python documentation `_ -and `packaging.python.org `_, -to easily cross-reference pages, sections and Python/C objects. -This works with both the "canonical" directives and anywhere in your PEP. - Add the directive between the headers and the first section of the PEP (typically the Abstract) and pass as an argument an Intersphinx reference of the canonical doc/spec