[Twisted-Python] Lore and generating reStructuredText (Lore2Sphinx)

Kevin Horn kevin.horn at gmail.com
Wed Mar 27 09:17:21 EDT 2013


On Tue, Mar 26, 2013 at 10:43 PM, Andrew Bennetts <andrew at bemusement.org>wrote:

> Kevin Horn wrote:
> […]
> > Why?  What does this buy us?  To me it seems more complicated, requires
> […]
> >
> > If it's just an incremental transition, then I think we can get that
> > without resorting to relying on the guts of two fairly complicated
> systems.
>
> Although I'm blissfully ignorant of the deeper, darker details of
> docutils and sphinx (and hope to remain so), I feel compelled to point
> out that an incremental transition is more than a “just”.  You can start
> reaping the rewards of the new system sooner and with less risk than an
> all-or-nothing transition, it reduces merge conflicts for
> work-in-progress doc branches, etc.
>
> So I'd say incremental transition is closer to a “must” than a “just”!
>
> -Andrew.
>

Yes, that was "just" in the sense of "only", rather than in the sense of
"merely". :)


--
Kevin Horn
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://twistedmatrix.com/pipermail/twisted-python/attachments/20130327/47a3f258/attachment.htm 


More information about the Twisted-Python mailing list