Re: RFC: Proposed new style for documenting and testing ZTK packages

Lennart Regebro <[email protected]>
Newsgroups gmane.comp.web.zope.devel
Message-ID <[email protected]>
On Sat, Apr 17, 2010 at 19:17, Tres Seaver <[email protected]> wrote:
> I'm ambivalent about testing the Sphinx code snippets on each test run.
>  I want those snippets to be *much* less comprehensive than they are
> currently, and am pretty sure that drift in the non-executable bits is
> at least as important a problem as drift in the snippets.

Well, unless they take of time, but they shouldn't, really. I think
it's positive to get a quick feedback if you are breaking the
documentation.

> +0 on running them every time IFF we can find an easy way to run them
> during 'setup.py test' as well as buildout, and we continue to be
> mindful of the distinction between docs that work primarily as docs and
> tests that cover every code path.

I think manuel should solve that, we'll see, I'll have to test.
I need to get manuel ported to Python 3 then too. :)

-- 
Lennart Regebro: http://regebro.wordpress.com/
Python 3 Porting: http://python-incompatibility.googlecode.com/
+33 661 58 14 64
_______________________________________________
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 )
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.