On 02:57 pm, kevin.horn@gmail.com wrote:
On Wed, Apr 21, 2010 at 9:48 PM, <exarkun@twistedmatrix.com> wrote:
So about the conversion, I wonder if we can start to generate the Sphinx version of the docs on buildbot sometime soon, and perhaps host them alongside the current docs, as the first step in phasing out the current version?
I suppose we could do this, if you think it would help. Note that the lore2sphinx script requires Python 2.6 and I think at least Sphinx 0.6.4 (I'm using 0.6.5).
Shouldn't be a problem.
How automated is the conversion process now? Are errors reported such that people could start looking at them and fixing the issues? It seems like you've done almost all of the hard work, and the rest is dealing with some edge cases in lore or restructured text, and that might be more easily spread out amongst more people.
Jean-Paul
I think the automatic conversion process has reached the point of diminishing returns. I've got it down to about 13 warnings in the Sphinx build process, though there are still some markup errors in the output. Trying to make the conversion handle these seems to just introduce more errors in other places.
Would it be easier to fix these by changing the lore sources? Jean-Paul