<br><br><div class="gmail_quote">On Wed, Apr 21, 2010 at 9:48 PM, <span dir="ltr"><<a href="mailto:exarkun@twistedmatrix.com">exarkun@twistedmatrix.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div><div></div><div class="h5"><br>
</div></div>So about the conversion, I wonder if we can start to generate the Sphinx<br>
version of the docs on buildbot sometime soon, and perhaps host them<br>
alongside the current docs, as the first step in phasing out the current<br>
version?<br></blockquote><div><br>I suppose we could do this, if you think it would help. Note that the lore2sphinx <br>script requires Python 2.6 and I think at least Sphinx 0.6.4 (I'm using 0.6.5).<br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<br>
How automated is the conversion process now? Are errors reported such<br>
that people could start looking at them and fixing the issues? It seems<br>
like you've done almost all of the hard work, and the rest is dealing<br>
with some edge cases in lore or restructured text, and that might be<br>
more easily spread out amongst more people.<br>
<br>
Jean-Paul<br>
<div><div></div><div class="h5"><br></div></div></blockquote></div><br>I think the automatic conversion process has reached the point of diminishing returns.<br>I've got it down to about 13 warnings in the Sphinx build process, though there are still<br>
some markup errors in the output. Trying to make the conversion handle these seems <br>to just introduce more errors in other places.<br><br>In other words I think it's time to create a branch with the Sphinxified docs and do a manual review.<br>
<br>I've got a basic transition plan sketched out here:<br><a href="http://twistedsphinx.funsize.net/transition_plan.html">http://twistedsphinx.funsize.net/transition_plan.html</a><br><br>That's just basically an outline of a plan Glyph and I hashed out during the Twisted sprint at PyCon.<br>
<br>Ideas and criticisms welcome.<br><br>Kevin Horn<br><div style="visibility: hidden; display: inline;" id="avg_ls_inline_popup"></div><style type="text/css">#avg_ls_inline_popup { position:absolute; z-index:9999; padding: 0px 0px; margin-left: 0px; margin-top: 0px; width: 240px; overflow: hidden; word-wrap: break-word; color: black; font-size: 10px; text-align: left; line-height: 13px;}</style>