Kevin Dangoor wrote: > 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.
I guess my understanding was that a roughdocs site would be a community-accessible parallel of the offical documentation. Versioning would be handled in exactly the same way, so that aspect of the conversion shouldn't be much of an issue. That said information vetting is still a problem. I don't really know how else to solve it besides doing it. As you said, you have to have someone competent looking at these things. Maybe it would be a good idea to have a system where people registered on the site can vote an unofficial article for inclusion, and that ranking can be used to help any reviewers determine figure out where to start looking for new official content. > > 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... Comments don't really provide a path for unofficial documentation to become official. Without that the only people who will be writing official docs are the ones who are responsible for official documentation. That is a lot more work than providing a structured way for the community to help. I think there were two big issues with official vs unofficial status management in the trac: 1) There were very few people handling official documentation, and they were busy with other important things, and 2) It was impossible for a "docs admin" to find documentation worthy of being made official without going through and reading it. I think having a roughdocs section could work, it is just the unoffiical->official pipeline that needs streamlining. -Adam --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
