Hi, I always liked the documentation of Apache Cocoon, where you have a separation into documentation for developers (people that want to hack code improving the framework) and users (people who want to use the framework without actually modifying it) and some other tracks.
They solve the overload problem by having collapsible menus. Is that something that could be done for SM? Ciao, Philipp Rossmanith > -----Mensaje original----- > De: James Strachan [mailto:[EMAIL PROTECTED] > Enviado el: lunes, 05 de marzo de 2007 15:25 > Para: servicemix-dev@geronimo.apache.org > Asunto: Re: Doc reorg > > On 2/21/07, Guillaume Nodet <[EMAIL PROTECTED]> wrote: > > I think we need to reorg the docs so that one can more easily > > find the informations (we also need to write more docs, but that's > > another problem). Currently, the only way to really find a page is > > to go to the site map and browse ... > > > > Any ideas on how to do that ? > > Its a tricky one. In some ways having a kinda SiteMap menu thingy on > the home page/navigation bar can help folks who know-what-they-want > navigate quickly to the right stuff. Sometimes that can be kinda > overload where new users don't know where to start (e.g. in the past > the ActiveMQ site has suffered, and still does I think, from > navigation-bar-overload). > > Maybe we need to put a bit more of the SiteMap onto the Navigation > bar? I wonder if CSS style popup menus might help reduce some of the > clutter of the Navigation bar while adding more of the SiteMap to the > average user? > http://www.grc.com/menu2/invitro.htm > > -- > > James > ------- > http://radio.weblogs.com/0112098/ This e-mail may contain confidential or privileged information. Any unauthorised copying, use or distribution of this information is strictly prohibited.
