See previous discussion over at the CPython repo:

• Docs: make it easier to reference and markup decorators python/cpython#105812
• Improve docs for typing.dataclass_transform python/cpython#105792 (comment)
• gh-105812: [PoC] add :deco: role and adapt some rst files python/cpython#118743

The decorator (:py:deco:) role would render the function/method reference with a prefixed @.