<div class="gmail_quote">On Wed, Dec 2, 2009 at 8:38 PM, <span dir="ltr"><<a href="mailto:exarkun@twistedmatrix.com">exarkun@twistedmatrix.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div class="im">On 2 Dec, 11:04 pm, <a href="mailto:kevin.horn@gmail.com">kevin.horn@gmail.com</a> wrote:<br>
>><br>
>>[1] <a href="http://twistedsphinx.funsize.net/proposal.html" target="_blank">http://twistedsphinx.funsize.net/proposal.html</a><br>
>>[2] <a href="http://twistedsphinx.funsize.net/index.html" target="_blank">http://twistedsphinx.funsize.net/index.html</a><br>
><br>
><br>
>Any of the core Twisted devs care to sound of regarding the proposed<br>
>timelines?<br>
><br>
>Silence implies consent. Or in this case approval... :)<br>
<br>
</div>Timeline might not be the right word, since as far as I can tell there's<br>
little that's actually about time there. :) Let me know if I overlooked<br>
something.<br>
<br></blockquote><div><br>Well, "timeline" was the word Glyph used previously for "order in which stuff will be done".<br>So that's what I stuck with.<br> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
As far as the (I'm going to call it) roadmap goes, the thought that's<br>
pushed its way to the fore for me is that I'd like to try this with<br>
something smaller and simpler than Twisted first. It would be nice if<br>
the Divmod projects would qualify here, but they may not be active<br>
enough for any real experience to accumulate.<br></blockquote><div> </div><div>I haven't run my lore2sphinx script against the Divmod stuff yet, but I could certainly try it.<br>The intention is to convert the Divmod stuff as well as the Twisted stuff eventually though.<br>
<br>I've been concentrating on the Twisted docs, since they seemed the highest priority, but I <br>could detour a bit if you like. Obviously that would slow progress on the Twisted stuff a little.<br> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
pyOpenSSL might work. It uses the original CPython tex documentation<br>
system, so the conversion would (presumably) be done with whatever tools<br>
were used for CPython's own documentation, not the new Lore->Sphinx<br>
converter. It would still be a useful way to get more familiar with<br>
Sphinx, though. The downside is that I'm pretty much the only Twisted<br>
developer who works on pyOpenSSL, so it wouldn't help anyone else get<br>
any experience.<br></blockquote><div><br>I have no idea what tools were originally used for that conversion. Might be interesting to try if we could find out though. Also, I presume we'd need the sources for the docs. Are they in the tarball? Or elsewhere?<br>
<br>Of course if your objective is to learn Sphinx, you might be better off converting the pyOpenSSL docs by hand. They seem pretty short (except for section 3).<br><br>If you'd like to try that, I'd be happy to assist.<br>
</div><div> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div><div class="h5">
Jean-Paul<br>
<br>
_______________________________________________<br>
Twisted-Python mailing list<br>
<a href="mailto:Twisted-Python@twistedmatrix.com">Twisted-Python@twistedmatrix.com</a><br>
<a href="http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python" target="_blank">http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python</a><br>
</div></div></blockquote></div><br>