PEP 727: Documentation Metadata in Typing

Paramspec doesn’t do this, as was pointed out already. If you’re looking for this, you actually want one of a few other proposals, and good documentation could be linked to in each relevant function

There’s the proposed ability to use typing.Unpack on typing.TypedDict for kwargs. Then if you have a bunch of functions with the same kwargs and purpose, the TypedDict can represent them and have an appropriate docstring which is local to the kwargs. This can be done without the proposed typing.Doc but is also just broadly useful even for more expressive typing.

Or to extract and re-use kwargs from functions which is explicitly about direct re-use, and may provide a good solution for that problem.