[Zope-dev] Why I dislike narrative doctests

[Jim Fulton]

On Apr 25, 2008, at 10:20 AM, Kent Tenney wrote:
> However, as Sphinx lowers the barrier to cross-referencing,

Sounds like I need to check that out. :)

> they will become
> important as link destinations from 'real' documentation.


Maaaybe.  I like doctests for readability even if they aren't  
documentation.  I'd be hesitant to link to d=non-documentation from  
documentation.

Jim

--
Jim Fulton
Zope Corporation