[Twisted-Python] Lore to Sphinx Conversion Progress Report

[exarkun at twistedmatrix.com]

On 2 Dec, 11:04 pm, kevin.horn at gmail.com wrote:
>>
>>[1] http://twistedsphinx.funsize.net/proposal.html
>>[2] http://twistedsphinx.funsize.net/index.html
>
>
>Any of the core Twisted devs care to sound of regarding the proposed
>timelines?
>
>Silence implies consent.  Or in this case approval... :)

Timeline might not be the right word, since as far as I can tell there's 
little that's actually about time there. :)  Let me know if I overlooked 
something.

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.

pyOpenSSL might work.  It uses the original CPython tex documentation 
system, so the conversion would (presumably) be done with whatever tools 
were used for CPython's own documentation, not the new Lore->Sphinx 
converter.  It would still be a useful way to get more familiar with 
Sphinx, though.  The downside is that I'm pretty much the only Twisted 
developer who works on pyOpenSSL, so it wouldn't help anyone else get 
any experience.

Jean-Paul