Re: [jira] Doc reorg

2007-03-16 Thread Guillaume Nodet

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 Documentation>Architecture 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)
- Developers>Tools 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 guide>ServiceMix 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

2007-03-16 Thread Rossmanith, Philipp

Some propositions:
- Everything under Documentation>Architecture 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)
- Developers>Tools 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 guide>ServiceMix 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

2007-03-15 Thread Guillaume Nodet

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/