➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients eric.araujo, ethan.furman, jaraco
Date 2021-12-24.22:29:09
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1640384949.68.0.127606209392.issue46126@roundup.psfhosted.org>
In-reply-to
Content 
> I presume I don't need to explain why docstrings are nice and preferable over comments.

Actually, can you?

Docstrings to document regular modules, classes or functions are a fine tool, especially with tools that extract them (pydoc, sphinx).  I don’t see the same need for test functions.
History
Date User Action Args
2021-12-24 22:29:09eric.araujosetrecipients: + eric.araujo, jaraco, ethan.furman
2021-12-24 22:29:09eric.araujosetmessageid: <1640384949.68.0.127606209392.issue46126@roundup.psfhosted.org>
2021-12-24 22:29:09eric.araujolinkissue46126 messages
2021-12-24 22:29:09eric.araujocreate