On Sun, May 8, 2022, at 6:15 AM, [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?
We are generally moving toward type annotations in Twisted. They are superior to @type because they can be automatically checked for correctness, e.g. by Mypy. I'd recommend use of type annotation syntax in all cases it can express, reserving @type for exceptional circumstances. ---Tom _______________________________________________ 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/SAUFCD234IDTR442O4W3XF43MTO5B2JR/ Code of Conduct: https://twisted.org/conduct
