On Thu, Dec 3, 2009 at 10:11 AM, Glyph Lefkowitz <gl...@twistedmatrix.com>wrote:
> > On Dec 3, 2009, at 10:06 AM, exar...@twistedmatrix.com wrote: > > 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. > > > Oh. I am definitely taking that as a given. Or rather: having frequently > interacted with the output of both sphinx and lore, I was already confident > that it was better than Lore in most ways before we began this conversation. > I had a few specific misgivings, which Kevin has since addressed. > > Sphinx clearly has the *features* that we need; Kevin's analysis looks > pretty thorough, and even the current error-laden converted documentation > serves as a reasonable proof of concept. Plus, the plan specifically > includes resolving the remaining issues with that documentation as a > prerequisite to getting it merged. > > So while I could believe that there will be bad things about Sphinx which > may surprise me, I find it hard to believe that I could be surprised by any > bug in Sphinx so awful that it would be *enough worse* than Lore to make > continuing to maintain Lore a preferable option, given the presence of a > documentation maintainer willing to do the drudgework of conversion. > > That said, it might be a good idea to do the Divmod project conversions > first for other reasons. They have less documentation, so there's less to > review, and the process could be completed more quickly, letting us get some > benefit out of the process earlier on. Since these projects are the only > known remaining users of lore, we could get rid of lore immediately when > twisted itself is converted, rather than letting it linger until its users > have converted. > > I think maybe I'll try to do a quickie conversion on one of the Divmod projects (probably Nevow) in the next couple of days. I'm not planning on doing a theme or anything yet...just the content conversion, followed by manual cleanup. Kevin Horn
_______________________________________________ Twisted-Python mailing list Twisted-Python@twistedmatrix.com http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python
