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, [email protected](mailto:[email protected])
> 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 -- [email protected](mailto:[email protected])
> To unsubscribe send an email to
> [email protected](mailto:[email protected])
> https://mail.python.org/mailman3/lists/twisted.python.org/
> Message archived at
> https://mail.python.org/archives/list/[email protected]/message/LRTDFNOSNTZSL257KBT7IBCJ7B6V5UTJ/
> Code of Conduct: https://twisted.org/conduct
_______________________________________________
Twisted mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/twisted.python.org/
Message archived at
https://mail.python.org/archives/list/[email protected]/message/3BXRORGLPIJZ6A6WZQ6VDBS3TKOSDOPG/
Code of Conduct: https://twisted.org/conduct
