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

[Benji York]

On Mon, Apr 19, 2010 at 7:21 AM, Charlie Clark
<charlie.clark at clark-consulting.eu> wrote:
> Narrative documentation forces you to explain yourself to someone else.
> Neither, however, will necessarily notice if you forget something: tests
> aren't documentation and docu [sic]

Quite true.  It is also true that tests should be well documented and
documentation should be well tested.  Some prefer doctests for both.
-- 
Benji York