Problem Description

python now has a @deprecated decorator: https://peps.python.org/pep-0702/

in pdoc it's just treated like a normal decorator and is quite easy to miss:

Proposal

display the deprecated message as a warning, something like this:

Additional context

the decorator isn't coming to python until 3.13, but it can currently be used older python versions by importing it from typing_extensions. vscode already supports it too