Am 08.01.2012 20:52, schrieb Alessandro Molina:
I think this is a very good idea, we just have to find a way to manage the issues related to wrong informations/spam.
That's the big problem. Our experience with using a wiki for the TG1 docs was not very good. Granted, we succeeded in creating fairly extensive online docs, but they were a mixed bag of good articles, not-so-good articles, bad articles, half done and outdated articles; and nobody had enough time & expertise to review these, so they became more and more rotten and unwieldy. We were heavily haunted by spammers, but nobody took the time to regularly check the site, delete the spam users and their entries. In the end, I did all the clean-up and converted the whole wiki to Sphinx docs. Though I did some reviewing and editing, they are still a mixed bag, incomplete and inconsistent.
People always hope that a huge crowd is there to write the articles, but in reality the mass are only consumers, not producers. And then they hop someday someone will review and edit all the stuff, but in reality this will never happen, because it is more time-consuming and boring to review and rewrite half-baked and disarranged stuff written by other people than writing consistent docs from scratch all by yourself.
So a wiki system for TG2 may help, but it still needs maintainers and editors who review and remove spam and organize all the articles into a reasonable and consistent whole. Don't underestimate these efforts.
The other problem is how to cover the different versions with one wiki. In the TG1 wiki we used different prefixes 1.0, 1.1 and 1.5 for the different versions, but this made the docs even more unwieldy, and while the 1.0 docs were still quite extensive, the 1.1 and 1.5 were much more sparse, because again nobody had enough time & expertise & motivation to copy updated versions of all the old 1.0 docs to the 1.1 and 1.5 sections.
Also, as far as I understand, Michael's idea was to write a new "book". While a wiki may be useful in collecting tutorials and recipes, I doubt that it can help in creating a more book-like documentation.
-- Christoph -- You received this message because you are subscribed to the Google Groups "TurboGears" 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?hl=en.
