PEP 727: Documentation Metadata in Typing

[jp-larose (Joël Larose)]

@ntessore

If parameter docstrings turn out to be a great idea, then maybe there will be a time to come up with “proper” syntax for the feature

@pf_moore

If we’re now proposing to add a way to write docstrings for function parameters, or for variables, we should either stick to that principle, or be very clear that parameter/variable docstrings are handled and viewed very differently than other docstrings.

Seems like this is where Revisiting attribute docstrings discussion comes in.