Reference glossary terms

Author: ncoghlan

source/discussions/single-source-version.rst

@@ -7,8 +7,8 @@ Single-sourcing the Project Version
 :Page Status: Complete
 :Last Reviewed: 2024-10-02
 
-Many Python :ref:`distribution packages <Distribution Package>` publish a single
-Python :ref:`import package <Import Package>` where it is desired that the runtime
+Many Python :term:`distribution packages <Distribution Package>` publish a single
+Python :term:`import package <Import Package>` where it is desired that the runtime
 ``__version__`` attribute on the import package report the same version specifier
 as :func:`importlib.metadata.version` reports for the distribution package
 (as described in :ref:`runtime-version-access`).

source/discussions/versioning.rst

@@ -176,15 +176,15 @@ since the latest release, setuptools-scm generates a version like
 Accessing version information at runtime
 ========================================
 
-Version information for all :ref:`distribution packages <Distribution Package>`
+Version information for all :term:`distribution packages <Distribution Package>`
 that are locally available in the current environment can be obtained at runtime
 using the standard library's :func:`importlib.metadata.version` function::
 
    >>> importlib.metadata.version("pip")
    '23.3.2'
 
 Many libraries also choose to version their top level
-:ref:`import packages <Import Package>` by providing a package level
+:term:`import packages <Import Package>` by providing a package level
 ``__version__`` attribute::
 
    >>> import pip