The docs would improve very quickly if even a small faction of this group's users would help out. If 5% committed just spent 10 minutes a week nearly 20 hours of improvements could be made. We as community need to figure out how to get people motivated to help out. I'm sure many would like to help out if we had a list of small tasks they could work on.
Well it turns out we have a huge task that could be broken into smaller tasks that would aid in improving the completeness of the docs. This groups archives has over 20,000 messages that contain far more useful information on TG than is currently available in docs. If we could mine all the useful bits out of these message and turn them into docs, a giant leap forward would have been made. This is a huge task and cannot be done without a large number of volunteers and some infrastructure to organize the effort. What we need is a small TG app that grabs all of this groups topics that are at least a week old and are not in the database and add them to a database with a status of "needs tagging" and also save the link to the topic. We then need a page that displays the newest say 25 topics that has a status of "needs tagging" in a list so that a user could select a topic and then be given the link to the topic for them to review and a series of check boxes to select tags for documentation. There would also have to be an option to state that no useful information for docs exists in the topic as well as info in the message is out of date. Once at least 3 people have tagged a topic the status of the topic would be changed to "tagging complete". Another page of the application could provide a list of tags with a progress bar that shows the documentation extraction progress of the topic tag. That is, it would give an indication of the progress that has been made in migrating useful information to the TG docs. For example, lets say there are 10 topics in the user group that has been tagged with identity. If someone has already gone through 3 of them and made modification to the TG docs to include the valuable information that was in the message then the topic could be closed so the progress bar would show 30% complete. Now this is just an idea that I had and realized that many other details would have to be worked out to make this happen but would like to know if anyone else thinks that this would be a useful way to improve the TG docs. Also would there be anyone who would be interested in leading this effort to get the infrastructure in place. I know I don't have time to lead this effort but would be more than willing to spend some time each week tagging topics and improving docs as I can. Here is also a start of a topic tags list: ajax ajax.dojo ajax.jquery ajax.mochikit ajax.moo.fx ajax.prototype ajax.rico ajax.scriptaculous ajax.yahoo!ui api cherrypy configuration controller database database.mysql database.postgresql database.sqlite decorators deployment fastdata identity installation internationalization json logging model orm orm.activemapper orm.sqlalchemy orm.sqlobject orm.turboentity plugins scheduler setuptools template template.buffet template.cheetah template.clearsilver template.django template.genshi template.htmlpy template.jinja template.kid template.myghty template.stan template.xslt template.zpt test test.mechanize test.nose test.selenium test.twill tgadmin tgwidgets toolbox toolbox.catwalk toolbox.modeldesigner troubleshooting tutorials view widgets wsgi --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
