Make use of the `:py:deco:` role in documentation

[Viicos]

Documentation

The :py:deco: role was added in Sphinx 8.2.0. The minimum required Sphinx version is 8.2.

Should we make use of this role to reference decorators in the documentation?

Crossref #105812, I can also close my issue in favor of this one.

cc @AA-Turner

[picnixz]

At first, I was tempted to close this one in favor of the other, but the other only discussed about adding the feature and not about using an existing one. If we need to re-use an issue later because some decorators roles are missing, I think it's better to use this one instead. So I think it's perhaps better to close the other as there is nothing to discuss about the "new" feature? (only its adoption which this issue could solely track).

cc @erlend-aasland @AlexWaygood @CAM-Gerlach as they were involved in the original issue

[erlend-aasland]

I think it is fine to reuse/retarget the existing issue.

[picnixz]

Ok, let's retarget the old issue then (I'll let you update the body)