On 11/12/06, gasolin <[EMAIL PROTECTED]> wrote: > > Based on your comment I think most people agree that its better to list > all information in docs front page. So I start this process in hybrid > way: prompt the most important docs (which direct related to > TurboGears, such as 'How to choose different template engine', 'widgets > intro', 'Identity intro', 'internationalization', 'Agile Test', 'Error > logging', and 'scheduler') to front page and let full list in 'Solving > specific problems' and 'Alternate Components' doc. > > The gray area which store most of docs are within 'Solving specific > problems', 'Alternate Components', and 'RoughDocs'. Should we list all > of them on front page? Or the hybrid way is clear enough?
If we don't list them on the front page, we should have another page where we list ALL docs. This second page should be linked very prominantly from the front page. If there's a clear structure, research has shown that people can find their way through huge documents and find what they are looking for. And as far as perceptions go, more is definitely better for docs in the open source world. Nobody has ever told me, "Oh, I didn't use that framework because there were too many Docs." Of course, I'll just use the search engine provided, and not worry about sorting through the huge list of docs. But you never know looking through the list of docs may still show me something I'd never have thought to search for... -- Mark Ramm-Christensen email: mark at compoundthinking dot com blog: www.compoundthinking.com/blog --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
