Re: RFC: Proposed new style for documenting and testing ZTK packages
Martin Aspeli <[email protected]>
| Newsgroups | gmane.comp.web.zope.devel |
|---|---|
| Message-ID | <[email protected]> |
On 18 April 2010 05:20, Tres Seaver <[email protected]> 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 _______________________________________________ Zope-Dev maillist - [email protected] https://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - https://mail.zope.org/mailman/listinfo/zope-announce https://mail.zope.org/mailman/listinfo/zope )