RE: [jira] Doc reorg
Some propositions: - Everything under DocumentationArchitecture should be moved to Developers... - In Developers, a division into information related to administration (e.g. becoming a committer, ...) and coding (e.g. architecture) would be appreciated - Supplying the glossary with names of standards and links to their implementations (e.g. WS-Notification) - DevelopersTools and Tooling and Utilities is misleading - One could divide the User documentation into parts which are related to/required by the JBI standard (such as explanation of JBI, Ant tasks) - servicemix-common might better be placed at a different location - Tutorials and Guides should be joined - User's guideServiceMix Components seems to be redundant with Documentation...JBI Components - Lightweight components could be placed under servicemix-lwcontainer to emphasize their connection Ciao, Philipp -Mensaje original- De: Guillaume Nodet [mailto:[EMAIL PROTECTED] Enviado el: jueves, 15 de marzo de 2007 11:44 Para: servicemix-dev@geronimo.apache.org Asunto: Re: [jira] Doc reorg Looks quite nice, congrats :-) I'm not very keen on changing the underlying engine, but the folding menu on the left seems quite usable. As Philip noted, it would be a nice and easy enhancement ... Is anyone willing to take a look at writing css /javascript to have a nice folding menu for ServiceMix ? On 3/15/07, kermitt [EMAIL PROTECTED] wrote: I would suggest to hav a look at what have done ivy , really great http://incubator.apache.org/ivy/write-doc.html gnodet 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 ? -- Cheers, Guillaume Nodet Architect, LogicBlaze (http://www.logicblaze.com/) Blog: http://gnodet.blogspot.com/ -- View this message in context: http://www.nabble.com/Doc-reorg-tf3269938s12049.html#a9491730 Sent from the ServiceMix - Dev mailing list archive at Nabble.com. -- Cheers, Guillaume Nodet Architect, LogicBlaze (http://www.logicblaze.com/) Blog: http://gnodet.blogspot.com/ This e-mail may contain confidential or privileged information. Any unauthorised copying, use or distribution of this information is strictly prohibited.
Re: [jira] Doc reorg
Cool, thx :-) I will try to take a close look. Feel free to start if you want to do so. Btw, I've seen you have added a new page, which is really great, so I have added you as a contributor in the Team page. Also, if you intend to work more on servicemix, you should send a CLA (this should be mandatory to edit the wiki afaik). On 3/16/07, Rossmanith, Philipp [EMAIL PROTECTED] wrote: Some propositions: - Everything under DocumentationArchitecture should be moved to Developers... - In Developers, a division into information related to administration (e.g. becoming a committer, ...) and coding (e.g. architecture) would be appreciated - Supplying the glossary with names of standards and links to their implementations (e.g. WS-Notification) - DevelopersTools and Tooling and Utilities is misleading - One could divide the User documentation into parts which are related to/required by the JBI standard (such as explanation of JBI, Ant tasks) - servicemix-common might better be placed at a different location - Tutorials and Guides should be joined - User's guideServiceMix Components seems to be redundant with Documentation...JBI Components - Lightweight components could be placed under servicemix-lwcontainer to emphasize their connection Ciao, Philipp -Mensaje original- De: Guillaume Nodet [mailto:[EMAIL PROTECTED] Enviado el: jueves, 15 de marzo de 2007 11:44 Para: servicemix-dev@geronimo.apache.org Asunto: Re: [jira] Doc reorg Looks quite nice, congrats :-) I'm not very keen on changing the underlying engine, but the folding menu on the left seems quite usable. As Philip noted, it would be a nice and easy enhancement ... Is anyone willing to take a look at writing css /javascript to have a nice folding menu for ServiceMix ? On 3/15/07, kermitt [EMAIL PROTECTED] wrote: I would suggest to hav a look at what have done ivy , really great http://incubator.apache.org/ivy/write-doc.html gnodet 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 ? -- Cheers, Guillaume Nodet Architect, LogicBlaze (http://www.logicblaze.com/) Blog: http://gnodet.blogspot.com/ -- View this message in context: http://www.nabble.com/Doc-reorg-tf3269938s12049.html#a9491730 Sent from the ServiceMix - Dev mailing list archive at Nabble.com. -- Cheers, Guillaume Nodet Architect, LogicBlaze (http://www.logicblaze.com/) Blog: http://gnodet.blogspot.com/ This e-mail may contain confidential or privileged information. Any unauthorised copying, use or distribution of this information is strictly prohibited. -- Cheers, Guillaume Nodet Architect, LogicBlaze (http://www.logicblaze.com/) Blog: http://gnodet.blogspot.com/
Re: [jira] Doc reorg
Looks quite nice, congrats :-) I'm not very keen on changing the underlying engine, but the folding menu on the left seems quite usable. As Philip noted, it would be a nice and easy enhancement ... Is anyone willing to take a look at writing css /javascript to have a nice folding menu for ServiceMix ? On 3/15/07, kermitt [EMAIL PROTECTED] wrote: I would suggest to hav a look at what have done ivy , really great http://incubator.apache.org/ivy/write-doc.html gnodet 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 ? -- Cheers, Guillaume Nodet Architect, LogicBlaze (http://www.logicblaze.com/) Blog: http://gnodet.blogspot.com/ -- View this message in context: http://www.nabble.com/Doc-reorg-tf3269938s12049.html#a9491730 Sent from the ServiceMix - Dev mailing list archive at Nabble.com. -- Cheers, Guillaume Nodet Architect, LogicBlaze (http://www.logicblaze.com/) Blog: http://gnodet.blogspot.com/
