The Turbogears online docs are not so bad, but unfortunately they are sometimes hard to find. In particular, the front page should be improved so that the most important doc pages and other overview pages are easier to find.
One of the problems is that the sections have a different hierarchy (as of 2007-12-06). E.g. the "recipes" and "learn" sections are structured with sub-headings, while the other sections are only structured with bullets points which do not appear in the table of contents - e.g. the sub-points of the the "reference" section, though they are very important.
I suggested on the mailing list that this should be changed, with either bullet points used in the learn and recipes sections or sub-headings used in the other sections, too.
Another suggestion on the mailing list was: "I think there is just way too much on that documentation front page, and much of the good information is scattered around. 90% of the stuff that is in the Recipes section should really be rolled into the Reference section. The rest should probably be pushed out to a separate Recipes page. By 'Recipe' I usually think of something like the Python Cookbook, with short snippets to perform quite specific tasks. I don't expect basic guides like 'Identity Management' or 'Overview of SQLObject' to be buried down there. They're fundamental parts of Turbogears and should surely form part of the Reference."
