John M Camara wrote: > 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".
Actually, it wouldn't even have to grab the topics, it could just pull info from the RSS feed[1] and handle it accordingly. The better choice, imo, would be to come up with a registration and unique message content combination that would allow people who wish to be part of this to tag content in a reply to the post. > > 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. I'll try to get some time to put something together today. Considering it would only have to parse RSS feeds it shouldn't be too hard. (famous last words) -Adam [1] http://groups.google.com/group/turbogears/feeds --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
