support `prop: Annotated[str, typing.Doc("...")]` as property document

[trim21]

Is your feature request related to a problem? Please describe. A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

PEP 727 support annotated types and add new class typing.Doc(backport with typing_extensions.Doc, this can be used to add doc to class property, and I hope sphinx autodoc could support this

for example: from this:

class File(NamedTuple):
    name: str
    """file name"""

to this:

class File(NamedTuple):
    name: Annotated[str, typing_extensions.Doc("file name")]

Describe the solution you'd like A clear and concise description of what you want to happen.

Describe alternatives you've considered A clear and concise description of any alternative solutions or features you've considered.

Additional context Add any other context or screenshots about the feature request here.

• [e.g. URL or Ticket]

[AA-Turner]

PEP 727 isn't accepted (and personally, I don't think it's the right solution to the problem discussed). As such I'll close this.

A

[trim21]

do we consider add this feature if it's accepted?

[AA-Turner]

Perhaps. Though typing.Doc has several drawbacks, so perhaps not.

A