[Twisted-Python] Lore and generating reStructuredText (Lore2Sphinx)
Andrew Bennetts
andrew at bemusement.org
Tue Mar 26 23:43:08 EDT 2013
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.
More information about the Twisted-Python
mailing list