I've been following TG for about 16 months. I've noted an ongoing background lament about how "we should have more complete docs". And while things may have gotten better, the documentation is still a disgrace compared to other frameworks like Rails. (And Rails is sometimes criticized for insufficient docs.)
Documentation sprints have come and gone, complete with reports from the battlefront about how amazingly well things were going and how much progress was being made. But after the sprints... nothing. The last sprint was no exception. I'm looking at docs.turbogears.org/1.0 for docs. Am I simply mistaken? Should I be looking somewhere else for official docs? Still no proper widget documentation. Still no proper API reference. And yet I distinctly remember a report from the last sprint that great progress was being made in that area. I've heard it said that the book documents TurboGears 1.0. It does not. It is not a reference. And compared to more in depth books like "Agile Programming With Rails", is really just an overview. Frankly, TG needs decent 1.0 reference documentation a *lot* more than it needs a 2.0. 1.0 was not supposed to be allowed out without complete docs... or so I remember hearing many times. And if it takes closing all TG branches on Trac to all tickets that are not documentation bug fixes than so be it. I apologize for the negative tone. And I really *do* appreciate all the hard work that has gone into writing the actual TG code. And I apologize if I have just screwed up and am not looking in the right place. (But please don't point me to yet another collection of little user-provided use case snippets on some wiki.) After 17 months, it is not at all unreasonable for users to expect real docs, and (silently) to move on to something else if they don't exist. --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
