Hello: Currently all docs are accessable by the Doc Index (Doc map). Its a good shape for tg docs. And I'd like to suggest a more user-oriented way to enance the usability for tg docs: "Show limit choises for users" in docs first page (or you can say "facade" the docs)
After reorganized, the first page of doc list can be something like this: ---------------------------------start doc list-------------------------------------------------------- * What TurboGears can do for you? [Demo & Tutorial] * How to install TurboGears? [Install & Deployment] * How to edit web pages in TurboGears? [Programming, Template, Widgets, and...] * How to design model with TurboGears? [Database, Admin interface, and...] * Doc Index (Keep current http://docs.turbogears.org/1.0 list here) --------------------------------end doc list--------------------------------------------------------- Explain: Why I suggest to organize docs in this way? Users are distributed from different spot of TG learning curve, we need document to help getting their work done. But we don't welcome the redundant infomation to distract us. In case list all docs in first page is not very efficient for a glance. The huge list scare newbies and it takes longer to find what we need. In above list, "edit web pages" & "design model" will host most docs there. this statements are obvious enough for newbies to find what they want. And its also good for people who are already familiar with MVC or web framework. These people can figure out there will be sub directories about 'template', 'AJAX' section in "edit web pages" link. and "SQLObject", "SQLAlchemy" section within "design model" links, and so on... With "Doc Index" link, all docs are accessable by the Doc Index (Doc map). In conclusion, my points are: * Facade the docs * Make related document in cluster How do you think? -- Fred --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears Docs" 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-docs -~----------~----~----~----~------~----~------~--~---
