[Zope-dev] RFC: Proposed new style for documenting and testing ZTK packages

Martin Aspeli optilude+lists at gmail.com
Sat Apr 17 23:27:06 EDT 2010


On 18 April 2010 05:20, Tres Seaver <tseaver at palladion.com> wrote:

> I'm not against having the snippets be executable, because I *do* want
> them to work.  I just don't want to encourage anyone to think that they
> are testing the software when they write the snippets, or execute them.
>  Executing the snippets is testing the documentation, not the software.

Everyone who's ever written a doctest, or is thinking about doing so:
Please frame this and hang it above your monitor. :-)

Martin


More information about the Zope-Dev mailing list