First: You are right. But ... >> And because that failed, you condemn the whole project >> as being essentially worthless as a base-technology to write webapps. > > Yes, because the failure demonstrates that the makers of the project > either a) never tested their product (which naturally comprises the > docs) or b) just don't care. And if it starts like this it's probable > that the same attitude will appear at other places as well when one > really starts to use TG.
All your problems are just the result of the fact that Turbogears documentation sucks. I went through exactly the same problems. There are different multiple pages describing the same thing in different ways, with errors or stuff left out. However, as soon as you have the stuff finally running and are past all the bad docs, you might agree that the Turbogears stack is more flexible than Django and makes development of web apps easier in many cases (e.g. when the web framework is not only a base for content publishing, as the focus of Django's creators was/is making web development _for content publishing_ as easy as possible). I guess that TG's documentation is bad because TG is just an accumulation of projects with some sugar on top, not a full-blown from-scratch project that needs a completely new documentation (which made the Django devs create their excellent one). (I don't want to say that TG being assembled means that it doesn't need documentation, it needs a better one.) So I'd propose that if you get your TG up running (it might be worth the effort), write a new straightforward documentation page on how you did it, see if it reproducible and covers the cases the other docs did, and then delete the non-working ones. There is more hope for the future: The merger with Pylons and BFG brings the chance of creating new docs which are on par with Django's as Pylons' documentation is usually very good and Pyramid will have a larger community due to three projects joining. -- 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.
