Hello, The TG 2.1 documentation is now highly ranked in a google search result. For instance, it's in the first or second result for these queries: "turbogears chameleon" "turbogears extjs" "turbogears repoze" "turbogears openid". My point is that the 2.1 doc tends to become the default doc for TG, even for newbies.
That's why IMHO this doc should be polished a bit further... And I have meet some concrete issues. - Big images are not displayed correctly: http://turbogears.org/2.1/docs/main/explorequickstart.html - The main content area is not large enough: http://turbogears.org/2.1/docs/main/Auth/Customization.html the code samples are hardly readable - It's hard to navigate within the doc, sometimes you can get lost. For example, I've googled "turbogears chameleon", the first result is: http://turbogears.org/2.1/docs/main/Templates/ChameleonGenshi.html Well not too much info... That's why I want to find info regarding the other templating engines. There should be a parent page or something... I don't see anything the the TOC. So, I have to truncate manually the URL to go to http://turbogears.org/2.1/docs/main/Templates... Not very straightforward. I know how hard, tedious, time consuming it can be to build a good documentation, but I really think there should be more improvements. Nice doc make the community happy :) So, here is my 2C: The central zone width should be dynamic, adapted to the screen resolution (perhaps with a max width). Then, I don't know if this is easily possible, but images should be shrunk and user could display them entirely with a click, in a modal popup for instance. Finally, the TOC sidebar should be out of the central area, to have more space (the zone under the sidebar is always blank). Cherry on the cake, it could be contracted/expanded with a mouse click. Cheers. -- 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.
