On Monday 10 March 2008, Martijn Pieters wrote: > I completely agree with Tres' and Wichert's statements on this. I only > use doctests where they actually would make sense as documentation, > the corner cases I always write as unit tests. The tools for dealing > with pure Python code are so much more powerful than for > python-embedded-in-text-with-prefixes, as well.
In my opinion it is as necessary to describe corner cases with words. In fact, corner cases often need even more documentation, because they are not obvious. Regards, Stephan -- Stephan Richter Web Software Design, Development and Training Google me. "Zope Stephan Richter" _______________________________________________ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )