[Twisted-Python] Lore to Sphinx Conversion Progress Report

[exarkun at twistedmatrix.com]

On 09:00 am, glyph at twistedmatrix.com wrote:
>
>On Dec 3, 2009, at 1:29 AM, Kevin Horn wrote:
>>On Wed, Dec 2, 2009 at 8:38 PM, <exarkun at twistedmatrix.com> wrote:
>>
>>As far as the (I'm going to call it) roadmap goes, the thought that's
>>pushed its way to the fore for me is that I'd like to try this with
>>something smaller and simpler than Twisted first.  It would be nice if
>>the Divmod projects would qualify here, but they may not be active
>>enough for any real experience to accumulate.
>
>>I haven't run my lore2sphinx script against the Divmod stuff yet, but 
>>I could certainly try it.  The intention is to convert the Divmod 
>>stuff as well as the Twisted stuff eventually though.
>>
>>I've been concentrating on the Twisted docs, since they seemed the 
>>highest priority, but I could detour a bit if you like.  Obviously 
>>that would slow progress on the Twisted stuff a little.
>
>While converting pyOpenSSL's documentation would be a worthwhile goal 
>in itself, I don't actually like this idea.
>
>Mainly I disagree with the premise that accumulation of experience is 
>necessary for the conversion.  But this is not a strong disagreement, 
>as I don't understand the motivation for saying so in the first place 
>:).

I want some experience with Sphinx so that can verify the premise that 
Sphinx is better than Lore.  So, the experience isn't necessary for the 
conversion, it's necessary for me to be comfortable that the conversion 
is a good idea.

Jean-Paul