[Twisted-Python] Lore and generating reStructuredText (Lore2Sphinx)
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
> 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”!
Yes, that was "just" in the sense of "only", rather than in the sense of
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Twisted-Python