On Fri, Apr 25, 2008 at 9:39 AM, Jim Fulton <[EMAIL PROTECTED]> wrote:
>
>  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.

I think even non-documentation doctests are documentation since they
demonstrate correct usage. They need to be explained in the linking
document, but they are invaluable as examples.

Seems like a natural separation of concerns.

>
>
>
>  Jim
>
>  --
>  Jim Fulton
>  Zope Corporation
>
>
>
_______________________________________________
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 )

Reply via email to