Note that :term: supports custom link text (sphinx-doc#13120)

vwheeler63 · web-flow · commit 3bc10dd90fc8 · 2025-01-29T00:07:08.000Z
diff --git a/doc/usage/referencing.rst b/doc/usage/referencing.rst
@@ -254,6 +254,9 @@ The following role creates a cross-reference to a term in a
    If you use a term that's not explained in a glossary, you'll get a warning
    during build.
 
+   This role also supports :ref:`custom link text <xref-modifiers>` from the general
+   cross-reference syntax.
+
 
 .. _any-role:
 
