[Zope-Coders] unit tests and doc strings
Guido van Rossum
guido@python.org
Sat, 05 Oct 2002 03:14:38 -0400
99% of all Zope tests don't use a doc string. There's a reason for
this: when a test has a doc string, only the doc string is printed.
This makes tracking down a failing test a major pain.
For this reason, can we agree on a policy that tests should not have
docstrings? I enforce that in Python and I'm much happier since I
started doing this.
There are only a few areas that have tests with docstrings (many of
them TAL-related?), cleaning them up will be a minor operation.
I only request this for the CVS HEAD.
--Guido van Rossum (home page: http://www.python.org/~guido/)