On Sep 23, 2006, at 2:44 AM, Jorge Vargas wrote: > they have 2 wiki's MoinMaster and MoinMoin. The idea is that > everything that is contributed goes into one and when a release comes > they run a script that dumps one wiki on top of the other. (I believe > this is customizable, and if it isn't we'll make it) > > The best advantage I see of this is that everyone can use > roughdocs.turbogears.org freely as a wiki, we can restrict the > template to just one and make this wiki suit for transformation, then > on the "real" site keep the docs. > > We won't have outdated docs cause roughdocs will be "deleted" on > each release.
We still need to differentiate between "official" and "unofficial" docs. The "official" docs need to be maintained by people who know TG well. The idea that the wiki would be self-correcting hasn't really played out on the Trac... there's a lot of stuff there that is not recommended procedure or just plain wrong. We also need to split on version, so that we can be sure that a doc that you're reading is relevant to what you're using. So, I don't think that having an open roughdocs server helps, because there would need to be a big cleanup process before a push. I think the comments are easier to deal with, because they have their own special display and each change can be vetted individually... that's my take, based on what we've encountered with the Trac. Kevin --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
