[issue46126] Unittest output drives developers to avoid docstrings

Éric Araujo report at bugs.python.org
Fri Dec 24 17:29:09 EST 2021


Éric Araujo <merwok at netwok.org> added the comment:

> 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.

----------
nosy: +eric.araujo

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue46126>
_______________________________________


More information about the Python-bugs-list mailing list