Personally I'd say that @type is effectively deprecated by the fact that pydoctor supports annotations now. (In fact I kind of hope Pydoctor eventually grows support for Annotated so you can eventually do def query(name: Doc[str, "The name of the thing to query"]) -> Doc[str, "The value associated with C{name}"]:, and avoid the possibility of misspelling parameter names, and get all the documentation inline.)

On May 8, 2022, at 6:15 AM, c.buhtz@posteo.jp(mailto:c.buhtz@posteo.jp) wrote: Hello,

I assume this is again a more religious question but I would be glad to hear your opinions and experiences about it.

Let's assume we are using Python 3.9 or higher and epytext as documentation format with pydocotor. Whould recommand to use type-annotations or @type to give type informations to the pydoctor generated documentation? _______________________________________________ Twisted mailing list -- twisted@python.org(mailto:twisted@python.org) To unsubscribe send an email to twisted-leave@python.org(mailto:twisted-leave@python.org) https://mail.python.org/mailman3/lists/twisted.python.org/ Message archived at https://mail.python.org/archives/list/twisted@python.org/message/LRTDFNOSNTZ... Code of Conduct: https://twisted.org/conduct