I would like to stick with reST, for couple of reasons: 1) It is separate and distinct from any particular flavor of wiki-syntax. Just about every wiki system uses its own particular syntax, and keeping them straight makes my head hurt. More importantly than my personal headaches, is that lots of people who develop wiki and other tools will make plugins or translators for something like reST, but finding a translator plugin for another flavor of wiki-syntax is hard.
2) reST seems better supported for python than other "plain-text markup languages" (like textile or markdown) due to docutils, which is after all, written in Python. Docutils makes it much easier to translate reST into format other than HTML, such as PDF as Karl mentioned above. 3) I already learned it and don't want to learn Moin's flavor of wiki in addition :) I already have to keep Tracwiki and Mediawiki in my head for work (obviously, this only applies to me) 4) I really hope that Docudo isn't dead, as i would still like to see a transition to it at some point in the future. However, development has completely stalled, as the SVN repository (and Trac) still isn't back up to my knowledge (it's been down since the TG stuff changed servers). I _think_ I'm basically the head of that project by default, as everyone else seems to have drifted away, and Ronald Jaramillo, who was writing most of it for a while, has been mostly MIA for some time now. I'm still waiting to hear back from Lee McFadden on when the Docudo stuff will be back online. I'm hoping that it will be before PyCon, as I was wanting to try and get some interest for a Docudo sprint (but that's hard to do when everything's down). 5) If we do end up using Docudo or some other tool (and I hope we will) we won't have to write the bit that translates the plain-text markup into html/pdf whatever, since docutils gives us this for free. just my 2 cents... Kevin Horn On 2/7/07, Karl Guertin <[EMAIL PROTECTED]> wrote: > > > MoinMoin compatibility issues aside (which I do need to look into) I > have no problems with rest. > > - Rest is more standard than moin syntax, which is an advantage if we > wind up changing doc tools/wikis in the future > - I plan on producing a documentation PDF, which rest facilitates > - We're already using it > > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears Docs" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/turbogears-docs?hl=en -~----------~----~----~----~------~----~------~--~---
