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

[Martin Aspeli]

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