[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/)