You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cxf.apache.org by Mark Juchems <mj...@gmail.com> on 2017/06/15 15:50:00 UTC
Noobie wanting to help with Documentation...
All,
Hey all. I'll tell you my brief story.
I work at Caterpillar and we work in the Azure cloud. We have always used
Jersey and continued that until we ran into some problems. Azure code uses
an outdated version of Jersey and when we had some problems we wanted to
update to Jersey 2.x. After of several hours of fiddling I decided to try
CXF. We now are using it and have had no problems.
I have written some docs on StackOverflow which can be seen here:
https://stackoverflow.com/documentation/cxf/topics
The main trouble I had with CXF was the documentation. There seems to be
several pages that are not complete and, since there are several ways to do
client side CXF, they got a bit confusing. I suggest a "2 minute tutorial"
like XStream has: http://x-stream.github.io/tutorial.html
What do you think?
I have also written a great Logger that we have used for years (ported it
from original Jersey one). It is in the StackOverflow documentation as
well.
mark
Re: Noobie wanting to help with Documentation...
Posted by Daniel Kulp <dk...@apache.org>.
You need to create an account in our confluence system:
https://cwiki.apache.org/confluence/display/CXF/Index
And then let me know your userid. After that, I can give that account permissions to edit the pages.
Dan
> On Jun 18, 2017, at 5:54 PM, Mark Juchems <mj...@gmail.com> wrote:
>
> Sergey,
>
> Thanks for the info. I have submitted the ICLA and it looks like it might
> take a bit to process.
>
> I am familiar with CXF Restful services only, so that would be my focus.
> So far in my career I have thankfully avoided SOAP.
>
> I will let you know when I get the ICLA set up (maybe you will be notified
> first?) and I can get started. I thought I could start with some small
> tutorials and go from there under your observation.
>
> mark juchems
>
>
>
>
> On Jun 16, 2017 5:07 AM, "Sergey Beryozkin" <sb...@gmail.com> wrote:
>
>> Hi Mark, Andriy
>>
>> Starting with a 2-min tutorial doc can be useful indeed: create a service,
>> create a client, do the configuration (Spring or Blueprint, client and/or
>> server), run.
>>
>> Mark, as far as I know you need to submit ICLA to the Apache before you
>> can start editing the wiki
>>
>> Thanks, Sergey
>>
>>
>>
>>
>> On 16/06/17 01:27, Andriy Redko wrote:
>>
>>> Hey Mark,
>>>
>>> I express my own opinion here but I have no doubts the CXF team
>>> would support it, making documentation useful, accurate and up-to-date
>>> would be terrific. If you are willing to help, that would be certainly
>>> appreciated by the community and the team. Do you have any particular
>>> plan / tutorials in mind you would like to tackle first? What kind of
>>> help you may need (examples, snippets, comments, clarifications, ...)?
>>> Thanks.
>>>
>>> Best Regards,
>>> Andriy Redko
>>>
>>> Thursday, June 15, 2017, 11:50:00 AM, you wrote:
>>>
>>> MJ> All,
>>>
>>> MJ> Hey all. I'll tell you my brief story.
>>>
>>> MJ> I work at Caterpillar and we work in the Azure cloud. We have always
>>> used
>>> MJ> Jersey and continued that until we ran into some problems. Azure
>>> code uses
>>> MJ> an outdated version of Jersey and when we had some problems we wanted
>>> to
>>> MJ> update to Jersey 2.x. After of several hours of fiddling I decided
>>> to try
>>> MJ> CXF. We now are using it and have had no problems.
>>>
>>> MJ> I have written some docs on StackOverflow which can be seen here:
>>> MJ> https://stackoverflow.com/documentation/cxf/topics
>>>
>>> MJ> The main trouble I had with CXF was the documentation. There seems
>>> to be
>>> MJ> several pages that are not complete and, since there are several ways
>>> to do
>>> MJ> client side CXF, they got a bit confusing. I suggest a "2 minute
>>> tutorial"
>>> MJ> like XStream has: http://x-stream.github.io/tutorial.html
>>>
>>> MJ> What do you think?
>>>
>>> MJ> I have also written a great Logger that we have used for years
>>> (ported it
>>> MJ> from original Jersey one). It is in the StackOverflow documentation
>>> as
>>> MJ> well.
>>>
>>> MJ> mark
>>>
>>>
>>
>> --
>> Sergey Beryozkin
>>
>> Talend Community Coders
>> http://coders.talend.com/
>>
--
Daniel Kulp
dkulp@apache.org - http://dankulp.com/blog
Talend Community Coder - http://coders.talend.com
Re: Noobie wanting to help with Documentation...
Posted by Sergey Beryozkin <sb...@gmail.com>.
Hi, Sure, so, given
http://cxf.apache.org/docs/jax-rs-client-api.html
what do you think is actually missing ? I guess I'm repeating now what
Andriy Redko asked earlier
Thanks, Sergey
On 19/06/17 16:53, Mark Juchems wrote:
> Sergey,
>
> I have just finished use the client stuff so I thought I would dive into
> that first. Thanks for all your help!
>
> mark
>
> On Mon, Jun 19, 2017 at 6:01 AM, Sergey Beryozkin <sb...@gmail.com>
> wrote:
>
>> Hi Mark
>>
>> I confirm your ICLA has been received, and now we'll wait for Dan (SOAP
>> guru :-)) to give you the edit permissions.
>> FYI, in general, we are very neutral in CXF, whichever approach
>> (SOAP/REST) works best for a given user project is worth the attention as
>> far as CXF is concerned.
>> I agree having a series of tutorials (starting from JAX-RS) will be good.
>> Which first tutorial you'd like to start with ?
>>
>> Cheers, Sergey
>>
>> On 18/06/17 22:54, Mark Juchems wrote:
>>
>>> Sergey,
>>>
>>> Thanks for the info. I have submitted the ICLA and it looks like it might
>>> take a bit to process.
>>>
>>> I am familiar with CXF Restful services only, so that would be my focus.
>>> So far in my career I have thankfully avoided SOAP.
>>>
>>> I will let you know when I get the ICLA set up (maybe you will be notified
>>> first?) and I can get started. I thought I could start with some small
>>> tutorials and go from there under your observation.
>>>
>>> mark juchems
>>>
>>>
>>>
>>>
>>> On Jun 16, 2017 5:07 AM, "Sergey Beryozkin" <sb...@gmail.com> wrote:
>>>
>>> Hi Mark, Andriy
>>>>
>>>> Starting with a 2-min tutorial doc can be useful indeed: create a
>>>> service,
>>>> create a client, do the configuration (Spring or Blueprint, client and/or
>>>> server), run.
>>>>
>>>> Mark, as far as I know you need to submit ICLA to the Apache before you
>>>> can start editing the wiki
>>>>
>>>> Thanks, Sergey
>>>>
>>>>
>>>>
>>>>
>>>> On 16/06/17 01:27, Andriy Redko wrote:
>>>>
>>>> Hey Mark,
>>>>>
>>>>> I express my own opinion here but I have no doubts the CXF team
>>>>> would support it, making documentation useful, accurate and up-to-date
>>>>> would be terrific. If you are willing to help, that would be certainly
>>>>> appreciated by the community and the team. Do you have any particular
>>>>> plan / tutorials in mind you would like to tackle first? What kind of
>>>>> help you may need (examples, snippets, comments, clarifications, ...)?
>>>>> Thanks.
>>>>>
>>>>> Best Regards,
>>>>> Andriy Redko
>>>>>
>>>>> Thursday, June 15, 2017, 11:50:00 AM, you wrote:
>>>>>
>>>>> MJ> All,
>>>>>
>>>>> MJ> Hey all. I'll tell you my brief story.
>>>>>
>>>>> MJ> I work at Caterpillar and we work in the Azure cloud. We have
>>>>> always
>>>>> used
>>>>> MJ> Jersey and continued that until we ran into some problems. Azure
>>>>> code uses
>>>>> MJ> an outdated version of Jersey and when we had some problems we
>>>>> wanted
>>>>> to
>>>>> MJ> update to Jersey 2.x. After of several hours of fiddling I decided
>>>>> to try
>>>>> MJ> CXF. We now are using it and have had no problems.
>>>>>
>>>>> MJ> I have written some docs on StackOverflow which can be seen here:
>>>>> MJ> https://stackoverflow.com/documentation/cxf/topics
>>>>>
>>>>> MJ> The main trouble I had with CXF was the documentation. There seems
>>>>> to be
>>>>> MJ> several pages that are not complete and, since there are several
>>>>> ways
>>>>> to do
>>>>> MJ> client side CXF, they got a bit confusing. I suggest a "2 minute
>>>>> tutorial"
>>>>> MJ> like XStream has: http://x-stream.github.io/tutorial.html
>>>>>
>>>>> MJ> What do you think?
>>>>>
>>>>> MJ> I have also written a great Logger that we have used for years
>>>>> (ported it
>>>>> MJ> from original Jersey one). It is in the StackOverflow documentation
>>>>> as
>>>>> MJ> well.
>>>>>
>>>>> MJ> mark
>>>>>
>>>>>
>>>>>
>>>> --
>>>> Sergey Beryozkin
>>>>
>>>> Talend Community Coders
>>>> http://coders.talend.com/
>>>>
>>>>
>>>
>
Re: Noobie wanting to help with Documentation...
Posted by Mark Juchems <mj...@gmail.com>.
Sergey,
I have just finished use the client stuff so I thought I would dive into
that first. Thanks for all your help!
mark
On Mon, Jun 19, 2017 at 6:01 AM, Sergey Beryozkin <sb...@gmail.com>
wrote:
> Hi Mark
>
> I confirm your ICLA has been received, and now we'll wait for Dan (SOAP
> guru :-)) to give you the edit permissions.
> FYI, in general, we are very neutral in CXF, whichever approach
> (SOAP/REST) works best for a given user project is worth the attention as
> far as CXF is concerned.
> I agree having a series of tutorials (starting from JAX-RS) will be good.
> Which first tutorial you'd like to start with ?
>
> Cheers, Sergey
>
> On 18/06/17 22:54, Mark Juchems wrote:
>
>> Sergey,
>>
>> Thanks for the info. I have submitted the ICLA and it looks like it might
>> take a bit to process.
>>
>> I am familiar with CXF Restful services only, so that would be my focus.
>> So far in my career I have thankfully avoided SOAP.
>>
>> I will let you know when I get the ICLA set up (maybe you will be notified
>> first?) and I can get started. I thought I could start with some small
>> tutorials and go from there under your observation.
>>
>> mark juchems
>>
>>
>>
>>
>> On Jun 16, 2017 5:07 AM, "Sergey Beryozkin" <sb...@gmail.com> wrote:
>>
>> Hi Mark, Andriy
>>>
>>> Starting with a 2-min tutorial doc can be useful indeed: create a
>>> service,
>>> create a client, do the configuration (Spring or Blueprint, client and/or
>>> server), run.
>>>
>>> Mark, as far as I know you need to submit ICLA to the Apache before you
>>> can start editing the wiki
>>>
>>> Thanks, Sergey
>>>
>>>
>>>
>>>
>>> On 16/06/17 01:27, Andriy Redko wrote:
>>>
>>> Hey Mark,
>>>>
>>>> I express my own opinion here but I have no doubts the CXF team
>>>> would support it, making documentation useful, accurate and up-to-date
>>>> would be terrific. If you are willing to help, that would be certainly
>>>> appreciated by the community and the team. Do you have any particular
>>>> plan / tutorials in mind you would like to tackle first? What kind of
>>>> help you may need (examples, snippets, comments, clarifications, ...)?
>>>> Thanks.
>>>>
>>>> Best Regards,
>>>> Andriy Redko
>>>>
>>>> Thursday, June 15, 2017, 11:50:00 AM, you wrote:
>>>>
>>>> MJ> All,
>>>>
>>>> MJ> Hey all. I'll tell you my brief story.
>>>>
>>>> MJ> I work at Caterpillar and we work in the Azure cloud. We have
>>>> always
>>>> used
>>>> MJ> Jersey and continued that until we ran into some problems. Azure
>>>> code uses
>>>> MJ> an outdated version of Jersey and when we had some problems we
>>>> wanted
>>>> to
>>>> MJ> update to Jersey 2.x. After of several hours of fiddling I decided
>>>> to try
>>>> MJ> CXF. We now are using it and have had no problems.
>>>>
>>>> MJ> I have written some docs on StackOverflow which can be seen here:
>>>> MJ> https://stackoverflow.com/documentation/cxf/topics
>>>>
>>>> MJ> The main trouble I had with CXF was the documentation. There seems
>>>> to be
>>>> MJ> several pages that are not complete and, since there are several
>>>> ways
>>>> to do
>>>> MJ> client side CXF, they got a bit confusing. I suggest a "2 minute
>>>> tutorial"
>>>> MJ> like XStream has: http://x-stream.github.io/tutorial.html
>>>>
>>>> MJ> What do you think?
>>>>
>>>> MJ> I have also written a great Logger that we have used for years
>>>> (ported it
>>>> MJ> from original Jersey one). It is in the StackOverflow documentation
>>>> as
>>>> MJ> well.
>>>>
>>>> MJ> mark
>>>>
>>>>
>>>>
>>> --
>>> Sergey Beryozkin
>>>
>>> Talend Community Coders
>>> http://coders.talend.com/
>>>
>>>
>>
Re: Noobie wanting to help with Documentation...
Posted by Sergey Beryozkin <sb...@gmail.com>.
Hi Mark
I confirm your ICLA has been received, and now we'll wait for Dan (SOAP
guru :-)) to give you the edit permissions.
FYI, in general, we are very neutral in CXF, whichever approach
(SOAP/REST) works best for a given user project is worth the attention
as far as CXF is concerned.
I agree having a series of tutorials (starting from JAX-RS) will be good.
Which first tutorial you'd like to start with ?
Cheers, Sergey
On 18/06/17 22:54, Mark Juchems wrote:
> Sergey,
>
> Thanks for the info. I have submitted the ICLA and it looks like it might
> take a bit to process.
>
> I am familiar with CXF Restful services only, so that would be my focus.
> So far in my career I have thankfully avoided SOAP.
>
> I will let you know when I get the ICLA set up (maybe you will be notified
> first?) and I can get started. I thought I could start with some small
> tutorials and go from there under your observation.
>
> mark juchems
>
>
>
>
> On Jun 16, 2017 5:07 AM, "Sergey Beryozkin" <sb...@gmail.com> wrote:
>
>> Hi Mark, Andriy
>>
>> Starting with a 2-min tutorial doc can be useful indeed: create a service,
>> create a client, do the configuration (Spring or Blueprint, client and/or
>> server), run.
>>
>> Mark, as far as I know you need to submit ICLA to the Apache before you
>> can start editing the wiki
>>
>> Thanks, Sergey
>>
>>
>>
>>
>> On 16/06/17 01:27, Andriy Redko wrote:
>>
>>> Hey Mark,
>>>
>>> I express my own opinion here but I have no doubts the CXF team
>>> would support it, making documentation useful, accurate and up-to-date
>>> would be terrific. If you are willing to help, that would be certainly
>>> appreciated by the community and the team. Do you have any particular
>>> plan / tutorials in mind you would like to tackle first? What kind of
>>> help you may need (examples, snippets, comments, clarifications, ...)?
>>> Thanks.
>>>
>>> Best Regards,
>>> Andriy Redko
>>>
>>> Thursday, June 15, 2017, 11:50:00 AM, you wrote:
>>>
>>> MJ> All,
>>>
>>> MJ> Hey all. I'll tell you my brief story.
>>>
>>> MJ> I work at Caterpillar and we work in the Azure cloud. We have always
>>> used
>>> MJ> Jersey and continued that until we ran into some problems. Azure
>>> code uses
>>> MJ> an outdated version of Jersey and when we had some problems we wanted
>>> to
>>> MJ> update to Jersey 2.x. After of several hours of fiddling I decided
>>> to try
>>> MJ> CXF. We now are using it and have had no problems.
>>>
>>> MJ> I have written some docs on StackOverflow which can be seen here:
>>> MJ> https://stackoverflow.com/documentation/cxf/topics
>>>
>>> MJ> The main trouble I had with CXF was the documentation. There seems
>>> to be
>>> MJ> several pages that are not complete and, since there are several ways
>>> to do
>>> MJ> client side CXF, they got a bit confusing. I suggest a "2 minute
>>> tutorial"
>>> MJ> like XStream has: http://x-stream.github.io/tutorial.html
>>>
>>> MJ> What do you think?
>>>
>>> MJ> I have also written a great Logger that we have used for years
>>> (ported it
>>> MJ> from original Jersey one). It is in the StackOverflow documentation
>>> as
>>> MJ> well.
>>>
>>> MJ> mark
>>>
>>>
>>
>> --
>> Sergey Beryozkin
>>
>> Talend Community Coders
>> http://coders.talend.com/
>>
>
Re: Noobie wanting to help with Documentation...
Posted by Mark Juchems <mj...@gmail.com>.
Sergey,
Thanks for the info. I have submitted the ICLA and it looks like it might
take a bit to process.
I am familiar with CXF Restful services only, so that would be my focus.
So far in my career I have thankfully avoided SOAP.
I will let you know when I get the ICLA set up (maybe you will be notified
first?) and I can get started. I thought I could start with some small
tutorials and go from there under your observation.
mark juchems
On Jun 16, 2017 5:07 AM, "Sergey Beryozkin" <sb...@gmail.com> wrote:
> Hi Mark, Andriy
>
> Starting with a 2-min tutorial doc can be useful indeed: create a service,
> create a client, do the configuration (Spring or Blueprint, client and/or
> server), run.
>
> Mark, as far as I know you need to submit ICLA to the Apache before you
> can start editing the wiki
>
> Thanks, Sergey
>
>
>
>
> On 16/06/17 01:27, Andriy Redko wrote:
>
>> Hey Mark,
>>
>> I express my own opinion here but I have no doubts the CXF team
>> would support it, making documentation useful, accurate and up-to-date
>> would be terrific. If you are willing to help, that would be certainly
>> appreciated by the community and the team. Do you have any particular
>> plan / tutorials in mind you would like to tackle first? What kind of
>> help you may need (examples, snippets, comments, clarifications, ...)?
>> Thanks.
>>
>> Best Regards,
>> Andriy Redko
>>
>> Thursday, June 15, 2017, 11:50:00 AM, you wrote:
>>
>> MJ> All,
>>
>> MJ> Hey all. I'll tell you my brief story.
>>
>> MJ> I work at Caterpillar and we work in the Azure cloud. We have always
>> used
>> MJ> Jersey and continued that until we ran into some problems. Azure
>> code uses
>> MJ> an outdated version of Jersey and when we had some problems we wanted
>> to
>> MJ> update to Jersey 2.x. After of several hours of fiddling I decided
>> to try
>> MJ> CXF. We now are using it and have had no problems.
>>
>> MJ> I have written some docs on StackOverflow which can be seen here:
>> MJ> https://stackoverflow.com/documentation/cxf/topics
>>
>> MJ> The main trouble I had with CXF was the documentation. There seems
>> to be
>> MJ> several pages that are not complete and, since there are several ways
>> to do
>> MJ> client side CXF, they got a bit confusing. I suggest a "2 minute
>> tutorial"
>> MJ> like XStream has: http://x-stream.github.io/tutorial.html
>>
>> MJ> What do you think?
>>
>> MJ> I have also written a great Logger that we have used for years
>> (ported it
>> MJ> from original Jersey one). It is in the StackOverflow documentation
>> as
>> MJ> well.
>>
>> MJ> mark
>>
>>
>
> --
> Sergey Beryozkin
>
> Talend Community Coders
> http://coders.talend.com/
>
Re: Noobie wanting to help with Documentation...
Posted by Sergey Beryozkin <sb...@gmail.com>.
Hi Mark, Andriy
Starting with a 2-min tutorial doc can be useful indeed: create a
service, create a client, do the configuration (Spring or Blueprint,
client and/or server), run.
Mark, as far as I know you need to submit ICLA to the Apache before you
can start editing the wiki
Thanks, Sergey
On 16/06/17 01:27, Andriy Redko wrote:
> Hey Mark,
>
> I express my own opinion here but I have no doubts the CXF team
> would support it, making documentation useful, accurate and up-to-date
> would be terrific. If you are willing to help, that would be certainly
> appreciated by the community and the team. Do you have any particular
> plan / tutorials in mind you would like to tackle first? What kind of
> help you may need (examples, snippets, comments, clarifications, ...)?
> Thanks.
>
> Best Regards,
> Andriy Redko
>
> Thursday, June 15, 2017, 11:50:00 AM, you wrote:
>
> MJ> All,
>
> MJ> Hey all. I'll tell you my brief story.
>
> MJ> I work at Caterpillar and we work in the Azure cloud. We have always used
> MJ> Jersey and continued that until we ran into some problems. Azure code uses
> MJ> an outdated version of Jersey and when we had some problems we wanted to
> MJ> update to Jersey 2.x. After of several hours of fiddling I decided to try
> MJ> CXF. We now are using it and have had no problems.
>
> MJ> I have written some docs on StackOverflow which can be seen here:
> MJ> https://stackoverflow.com/documentation/cxf/topics
>
> MJ> The main trouble I had with CXF was the documentation. There seems to be
> MJ> several pages that are not complete and, since there are several ways to do
> MJ> client side CXF, they got a bit confusing. I suggest a "2 minute tutorial"
> MJ> like XStream has: http://x-stream.github.io/tutorial.html
>
> MJ> What do you think?
>
> MJ> I have also written a great Logger that we have used for years (ported it
> MJ> from original Jersey one). It is in the StackOverflow documentation as
> MJ> well.
>
> MJ> mark
>
--
Sergey Beryozkin
Talend Community Coders
http://coders.talend.com/
Re: Noobie wanting to help with Documentation...
Posted by Andriy Redko <dr...@gmail.com>.
Hey Mark,
I express my own opinion here but I have no doubts the CXF team
would support it, making documentation useful, accurate and up-to-date
would be terrific. If you are willing to help, that would be certainly
appreciated by the community and the team. Do you have any particular
plan / tutorials in mind you would like to tackle first? What kind of
help you may need (examples, snippets, comments, clarifications, ...)?
Thanks.
Best Regards,
Andriy Redko
Thursday, June 15, 2017, 11:50:00 AM, you wrote:
MJ> All,
MJ> Hey all. I'll tell you my brief story.
MJ> I work at Caterpillar and we work in the Azure cloud. We have always used
MJ> Jersey and continued that until we ran into some problems. Azure code uses
MJ> an outdated version of Jersey and when we had some problems we wanted to
MJ> update to Jersey 2.x. After of several hours of fiddling I decided to try
MJ> CXF. We now are using it and have had no problems.
MJ> I have written some docs on StackOverflow which can be seen here:
MJ> https://stackoverflow.com/documentation/cxf/topics
MJ> The main trouble I had with CXF was the documentation. There seems to be
MJ> several pages that are not complete and, since there are several ways to do
MJ> client side CXF, they got a bit confusing. I suggest a "2 minute tutorial"
MJ> like XStream has: http://x-stream.github.io/tutorial.html
MJ> What do you think?
MJ> I have also written a great Logger that we have used for years (ported it
MJ> from original Jersey one). It is in the StackOverflow documentation as
MJ> well.
MJ> mark