René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Docs: make it easier to reference and markup decorators","articleBody":"_Originally posted by @erlend-aasland in https://github.com/python/cpython/pull/105792#discussion_r1230584709_\r\n            \r\n\u003e 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` ``` =\u003e [@dataclasses.dataclass](https://docs.python.org/3.13/library/dataclasses.html#dataclasses.dataclass).\r\n\r\n\r\nThere'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.\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-118743\n* gh-139598\n* gh-139619\n* gh-139627\n* gh-139628\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/erlend-aasland","@type":"Person","name":"erlend-aasland"},"datePublished":"2023-06-15T08:16:30.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":11},"url":"https://github.com/105812/cpython/issues/105812"}