You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@servicemix.apache.org by Gert Vanthienen <ge...@gmail.com> on 2009/04/01 09:44:10 UTC
Re: Google Summer of Code 2009
Khaled,
I'm not sure projects about documentation would really get a lot of
attention, but you're absolutely right about the problems with our
documentation. Actually, I think the problem is twofold:
- some areas are probably really underdocumented and you can hardly
find anything about it on the website
- most things do have some kind of documentation, but the organisation
of the documentation is really bad
Especially for ServiceMix 4, the documentation seems to be all
scattered around: you'll find bits in the ServiceMix Kernel wiki, the
NMR wiki and for the components and the Maven tools you'll have to go
into the main ServiceMix (3) wiki/website.
With all that being said, we're particularly open to any kind of
suggestion on how to improve things (or even a helping hand ;) ).
Could you give us an overview of the information you were looking for
so we can figure out a way to get that together to start with or
something?
Regards,
Gert Vanthienen
------------------------
Open Source SOA: http://fusesource.com
Blog: http://gertvanthienen.blogspot.com/
2009/3/31 Khaled Essghaier <th...@gmail.com>:
> Hi,
> looks very interesting, i am a student actually and working actually in a
> SOA project in which we are planning to use an ESB but i think that you
> should consider projects related with the documentation and samples because
> i got a hard time those couple of weeks trying to get something working with
> SM4 which lead me to consider using open-ESB.
>
> Regards,
>
> *Khaled*
> ________________________________________________________
>
> My blog = http://thepurplecows.blogspot.com/
>
Re: Google Summer of Code 2009
Posted by Lars Heinemann <lh...@apache.org>.
JB,
that seems to be a nice idea. +1 from my side. DocBook is the right
approach I would think.
Regards
Lars
2009/4/1 Jean-Baptiste Onofré <jb...@nanthrax.net>:
> Maybe we can think about a kind of documentation reference stored in the svn
> repo (in the DocBook format for example). We can add the documentation
> generation in the continuous integration process to generate HTML/PDF.
>
> Providing a more "professional" PDF user guide can be a skill.
>
> Would you like that I raise a Jira task around this and begin the
> documentation project structure ?
>
> Regards
> JB
>
> Gert Vanthienen wrote:
>>
>> Khaled,
>>
>> I'm not sure projects about documentation would really get a lot of
>> attention, but you're absolutely right about the problems with our
>> documentation. Actually, I think the problem is twofold:
>> - some areas are probably really underdocumented and you can hardly
>> find anything about it on the website
>> - most things do have some kind of documentation, but the organisation
>> of the documentation is really bad
>>
>> Especially for ServiceMix 4, the documentation seems to be all
>> scattered around: you'll find bits in the ServiceMix Kernel wiki, the
>> NMR wiki and for the components and the Maven tools you'll have to go
>> into the main ServiceMix (3) wiki/website.
>>
>> With all that being said, we're particularly open to any kind of
>> suggestion on how to improve things (or even a helping hand ;) ).
>> Could you give us an overview of the information you were looking for
>> so we can figure out a way to get that together to start with or
>> something?
>>
>> Regards,
>>
>> Gert Vanthienen
>> ------------------------
>> Open Source SOA: http://fusesource.com
>> Blog: http://gertvanthienen.blogspot.com/
>>
>>
>>
>> 2009/3/31 Khaled Essghaier <th...@gmail.com>:
>>>
>>> Hi,
>>> looks very interesting, i am a student actually and working actually in a
>>> SOA project in which we are planning to use an ESB but i think that you
>>> should consider projects related with the documentation and samples
>>> because
>>> i got a hard time those couple of weeks trying to get something working
>>> with
>>> SM4 which lead me to consider using open-ESB.
>>>
>>> Regards,
>>>
>>> *Khaled*
>>> ________________________________________________________
>>>
>>> My blog = http://thepurplecows.blogspot.com/
>>>
>
--
http://lhein.blogspot.com
Re: Google Summer of Code 2009
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
Maybe we can think about a kind of documentation reference stored in the
svn repo (in the DocBook format for example). We can add the
documentation generation in the continuous integration process to
generate HTML/PDF.
Providing a more "professional" PDF user guide can be a skill.
Would you like that I raise a Jira task around this and begin the
documentation project structure ?
Regards
JB
Gert Vanthienen wrote:
> Khaled,
>
> I'm not sure projects about documentation would really get a lot of
> attention, but you're absolutely right about the problems with our
> documentation. Actually, I think the problem is twofold:
> - some areas are probably really underdocumented and you can hardly
> find anything about it on the website
> - most things do have some kind of documentation, but the organisation
> of the documentation is really bad
>
> Especially for ServiceMix 4, the documentation seems to be all
> scattered around: you'll find bits in the ServiceMix Kernel wiki, the
> NMR wiki and for the components and the Maven tools you'll have to go
> into the main ServiceMix (3) wiki/website.
>
> With all that being said, we're particularly open to any kind of
> suggestion on how to improve things (or even a helping hand ;) ).
> Could you give us an overview of the information you were looking for
> so we can figure out a way to get that together to start with or
> something?
>
> Regards,
>
> Gert Vanthienen
> ------------------------
> Open Source SOA: http://fusesource.com
> Blog: http://gertvanthienen.blogspot.com/
>
>
>
> 2009/3/31 Khaled Essghaier <th...@gmail.com>:
>> Hi,
>> looks very interesting, i am a student actually and working actually in a
>> SOA project in which we are planning to use an ESB but i think that you
>> should consider projects related with the documentation and samples because
>> i got a hard time those couple of weeks trying to get something working with
>> SM4 which lead me to consider using open-ESB.
>>
>> Regards,
>>
>> *Khaled*
>> ________________________________________________________
>>
>> My blog = http://thepurplecows.blogspot.com/
>>
Re: Google Summer of Code 2009
Posted by Charles Moulliard <cm...@gmail.com>.
Here is a link where discussions about the EJB container Apache openEJB
(osgified) and integration with servicemix integration have been discussed
(jira link + discussion)
http://mail-archives.apache.org/mod_mbox/openejb-users/200902.mbox/%3C22221368.post@talk.nabble.com%3E
Remark : i completely agrees with the documentation comments. We need to
improve and propose something similar to the wiki web site of Camel (where
the doc can be generated in PDF)
Regards,
Charles
On Thu, Apr 2, 2009 at 2:29 PM, Jean-Baptiste Onofré <jb...@nanthrax.net>wrote:
> Hi Khaled,
>
> what is very surprising is the fact that no one have the right answer at
>> least for the first use case
>>
> I think that we already have some material around this. Indeed, I have
> ServiceMix deployed in production that use EJB via CXF-SE.
> I'm very sorry, I haven't had any time for now to upgrade the SMX4 EJB
> documentation. I try to do it as soon as possible.
>
> We have discussed this morning (in the dev mailing list) with Guillaume to
> add an EJB3 container embedded in SMX4. I think it's a killer feature, so we
> need to going deeper in this way.
>
> Back to the documentation part i think that the first things to do is
>> to restructure the documentation and to complete the missing parts
>> (especially the blank pages in SM website) as Gert said.
>> the PDF thing is just how to deliver this documentation which very useful
>> for off line usage and can be shipped with SM releases.BTW i think that
>> confluence can generate PDF files thanks to plugins:
>> http://confluence.atlassian.com/display/DOC/Confluence+to+PDF
>>
>> Some folks talked about making an open source book for SM in the users
>> mailing list see :
>>
>> http://cwiki.apache.org/SM/discussion-forums.html#nabble-td22374793|a22374793<http://cwiki.apache.org/SM/discussion-forums.html#nabble-td22374793%7Ca22374793>
>> i think that is a great idea too.
>>
> I'm agree. I have proposed to create a documentation project, build in the
> continuous integration process. This documentation project will publish
> DocBook in several output formats (such as PDF/HTML). I have a positive
> feedback from Lars, I'm waiting for feedback from other team members.
>
> Regards
> JB
>
>
>>
>> Regards
>>
>> Khaled
>>
>> ________________________________________________________
>>
>> My blog = http://thepurplecows.blogspot.com/
>>
>>
>> On Wed, Apr 1, 2009 at 8:44 AM, Gert Vanthienen
>> <ge...@gmail.com>wrote:
>>
>> Khaled,
>>>
>>> I'm not sure projects about documentation would really get a lot of
>>> attention, but you're absolutely right about the problems with our
>>> documentation. Actually, I think the problem is twofold:
>>> - some areas are probably really underdocumented and you can hardly
>>> find anything about it on the website
>>> - most things do have some kind of documentation, but the organisation
>>> of the documentation is really bad
>>>
>>> Especially for ServiceMix 4, the documentation seems to be all
>>> scattered around: you'll find bits in the ServiceMix Kernel wiki, the
>>> NMR wiki and for the components and the Maven tools you'll have to go
>>> into the main ServiceMix (3) wiki/website.
>>>
>>> With all that being said, we're particularly open to any kind of
>>> suggestion on how to improve things (or even a helping hand ;) ).
>>> Could you give us an overview of the information you were looking for
>>> so we can figure out a way to get that together to start with or
>>> something?
>>>
>>> Regards,
>>>
>>> Gert Vanthienen
>>> ------------------------
>>> Open Source SOA: http://fusesource.com
>>> Blog: http://gertvanthienen.blogspot.com/
>>>
>>>
>>>
>>> 2009/3/31 Khaled Essghaier <th...@gmail.com>:
>>>
>>>> Hi,
>>>> looks very interesting, i am a student actually and working actually in
>>>> a
>>>> SOA project in which we are planning to use an ESB but i think that you
>>>> should consider projects related with the documentation and samples
>>>>
>>> because
>>>
>>>> i got a hard time those couple of weeks trying to get something working
>>>>
>>> with
>>>
>>>> SM4 which lead me to consider using open-ESB.
>>>>
>>>> Regards,
>>>>
>>>> *Khaled*
>>>> ________________________________________________________
>>>>
>>>> My blog = http://thepurplecows.blogspot.com/
>>>>
>>>>
>>
Re: Google Summer of Code 2009
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
Hi Khaled,
> what is very surprising is the fact that no one have the right answer at
> least for the first use case
I think that we already have some material around this. Indeed, I have
ServiceMix deployed in production that use EJB via CXF-SE.
I'm very sorry, I haven't had any time for now to upgrade the SMX4 EJB
documentation. I try to do it as soon as possible.
We have discussed this morning (in the dev mailing list) with Guillaume
to add an EJB3 container embedded in SMX4. I think it's a killer
feature, so we need to going deeper in this way.
> Back to the documentation part i think that the first things to do is
> to restructure the documentation and to complete the missing parts
> (especially the blank pages in SM website) as Gert said.
> the PDF thing is just how to deliver this documentation which very useful
> for off line usage and can be shipped with SM releases.BTW i think that
> confluence can generate PDF files thanks to plugins:
> http://confluence.atlassian.com/display/DOC/Confluence+to+PDF
>
> Some folks talked about making an open source book for SM in the users
> mailing list see :
> http://cwiki.apache.org/SM/discussion-forums.html#nabble-td22374793|a22374793
> i think that is a great idea too.
I'm agree. I have proposed to create a documentation project, build in
the continuous integration process. This documentation project will
publish DocBook in several output formats (such as PDF/HTML). I have a
positive feedback from Lars, I'm waiting for feedback from other team
members.
Regards
JB
>
>
> Regards
>
> Khaled
>
> ________________________________________________________
>
> My blog = http://thepurplecows.blogspot.com/
>
>
> On Wed, Apr 1, 2009 at 8:44 AM, Gert Vanthienen
> <ge...@gmail.com>wrote:
>
>> Khaled,
>>
>> I'm not sure projects about documentation would really get a lot of
>> attention, but you're absolutely right about the problems with our
>> documentation. Actually, I think the problem is twofold:
>> - some areas are probably really underdocumented and you can hardly
>> find anything about it on the website
>> - most things do have some kind of documentation, but the organisation
>> of the documentation is really bad
>>
>> Especially for ServiceMix 4, the documentation seems to be all
>> scattered around: you'll find bits in the ServiceMix Kernel wiki, the
>> NMR wiki and for the components and the Maven tools you'll have to go
>> into the main ServiceMix (3) wiki/website.
>>
>> With all that being said, we're particularly open to any kind of
>> suggestion on how to improve things (or even a helping hand ;) ).
>> Could you give us an overview of the information you were looking for
>> so we can figure out a way to get that together to start with or
>> something?
>>
>> Regards,
>>
>> Gert Vanthienen
>> ------------------------
>> Open Source SOA: http://fusesource.com
>> Blog: http://gertvanthienen.blogspot.com/
>>
>>
>>
>> 2009/3/31 Khaled Essghaier <th...@gmail.com>:
>>> Hi,
>>> looks very interesting, i am a student actually and working actually in a
>>> SOA project in which we are planning to use an ESB but i think that you
>>> should consider projects related with the documentation and samples
>> because
>>> i got a hard time those couple of weeks trying to get something working
>> with
>>> SM4 which lead me to consider using open-ESB.
>>>
>>> Regards,
>>>
>>> *Khaled*
>>> ________________________________________________________
>>>
>>> My blog = http://thepurplecows.blogspot.com/
>>>
>
Re: Google Summer of Code 2009
Posted by Khaled Essghaier <th...@gmail.com>.
Hi Gert,
Sorry for the late response.I am working in my graduation project so i am
pretty busy until June which make me not very useful until then but i will
glad to help in making things better.
Some of use cases of my application i am about to develop are :
- To be able to invoke EJB3 functionality from within SM4 and vice versa
- To use BPEL for orchestration of services
what is very surprising is the fact that no one have the right answer at
least for the first use case, i am may not be very skilled
or experimented but i thought that using an ESB is in part about integration
between legacy apps and new ones and in most cases they are JEE apps but
that's me :)
Back to the documentation part i think that the first things to do is
to restructure the documentation and to complete the missing parts
(especially the blank pages in SM website) as Gert said.
the PDF thing is just how to deliver this documentation which very useful
for off line usage and can be shipped with SM releases.BTW i think that
confluence can generate PDF files thanks to plugins:
http://confluence.atlassian.com/display/DOC/Confluence+to+PDF
Some folks talked about making an open source book for SM in the users
mailing list see :
http://cwiki.apache.org/SM/discussion-forums.html#nabble-td22374793|a22374793
i think that is a great idea too.
Regards
Khaled
________________________________________________________
My blog = http://thepurplecows.blogspot.com/
On Wed, Apr 1, 2009 at 8:44 AM, Gert Vanthienen
<ge...@gmail.com>wrote:
> Khaled,
>
> I'm not sure projects about documentation would really get a lot of
> attention, but you're absolutely right about the problems with our
> documentation. Actually, I think the problem is twofold:
> - some areas are probably really underdocumented and you can hardly
> find anything about it on the website
> - most things do have some kind of documentation, but the organisation
> of the documentation is really bad
>
> Especially for ServiceMix 4, the documentation seems to be all
> scattered around: you'll find bits in the ServiceMix Kernel wiki, the
> NMR wiki and for the components and the Maven tools you'll have to go
> into the main ServiceMix (3) wiki/website.
>
> With all that being said, we're particularly open to any kind of
> suggestion on how to improve things (or even a helping hand ;) ).
> Could you give us an overview of the information you were looking for
> so we can figure out a way to get that together to start with or
> something?
>
> Regards,
>
> Gert Vanthienen
> ------------------------
> Open Source SOA: http://fusesource.com
> Blog: http://gertvanthienen.blogspot.com/
>
>
>
> 2009/3/31 Khaled Essghaier <th...@gmail.com>:
> > Hi,
> > looks very interesting, i am a student actually and working actually in a
> > SOA project in which we are planning to use an ESB but i think that you
> > should consider projects related with the documentation and samples
> because
> > i got a hard time those couple of weeks trying to get something working
> with
> > SM4 which lead me to consider using open-ESB.
> >
> > Regards,
> >
> > *Khaled*
> > ________________________________________________________
> >
> > My blog = http://thepurplecows.blogspot.com/
> >
>