Doctests and edge cases (was: [Zope-dev] Re: zope.sendmail Retry fixes and new state machine.)

[Dieter Maurer]

Andreas Jung wrote at 2008-3-11 06:43 +0100:
> ...
>This sounds like writing doctests just for sake of having doctests for all 
>and everything. I completely disagree with that. In complex algorithms 
>edgecases are often only of interest for the person implementing the code 
>in order for having a safety belt. For writing good doctests you have to be 
>a good (English) writer at some point. Doctests come into the game if you 
>want to tell other people about the usage of your module. It's basically 
>not of interest for telling them all edgecases. Addressing edgecase is 
>unittests is basically good enough for me. They sometime require more code 
>to test and put this into a doctest is often just overhead.

+1


-- 
Dieter