Originally posted by @erlend-aasland in #105792 (comment)

It would be nice if we had a "decorator role" that used the Python function/method markup, but instead of adding trailing parens, added a prefixing '@': :decorator:`dataclasses.dataclass` => @dataclasses.dataclass.

There's already decorator and decoratormethod directives for signatures. Perhaps we can exploit these so the :py:meth: and py:func: roles adapt the format according to what directive is used. A role could be a nice supplement, though; sometimes we want to explicitly refer to a decorator as a function or the other way around.

Linked PRs

• gh-105812: [PoC] add :deco: role and adapt some rst files #118743
• gh-105812: Make use of the Sphinx deco role in documentation, part 1 #139598
• gh-105812: Use the :deco: role in place of manual decorator markup #139619
• [3.14] gh-105812: Use the :deco: role in place of manual decorator markup (GH-139619) #139627
• [3.13] gh-105812: Use the :deco: role in place of manual decorator markup (GH-139619) #139628