[
https://issues.apache.org/jira/browse/AXIS2C-721?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12547473
]
Senaka Fernando commented on AXIS2C-721:
----------------------------------------
Hi Dushshantha,
What I mean is, since, we want to make Axis2/C user friendly, it is better to
have a guide that gradually builds a service/client from the most basic "hello
world", into a bit complex service. The features should be added one by one, so
that the user will not see all at once. The guide is fine for a person who is
familiar with how Axis2/C works. That means a person who understands how the
various components of the engine interacts.
But, our user guide also should cater for the needs of folks who know nothing
about the Axis2/C Framework to write a service/client.
The issue does not lie in the content of our documentation. It is the way it is
being presented I guess.
Just let me point out a fact. For instance, someone who is new to Axis2/C, and
to web services in general, will wonder what we mean by XML payload at the very
beginning. To see the payload you must run the service and the client. Then the
user can use a tool like TCPMon and see the exchanged payloads. We also, can
add some screen shots (I don't think it would be a harm).
I believe the user guide is a bit advanced to read and understand for a new
user. You need to approach someone who knows C, but knows nothing about Axis2/C.
I'm not asking someone to write a book, but, I guess we could do some
modification to the existing doc.
Thanks,
Senaka
P.S. also note that the issue is a wish and not a bug. :-)
> Requesting step-by-step guides
> ------------------------------
>
> Key: AXIS2C-721
> URL: https://issues.apache.org/jira/browse/AXIS2C-721
> Project: Axis2-C
> Issue Type: Wish
> Components: documentation
> Reporter: Senaka Fernando
> Assignee: Dushshantha Chandradasa
> Fix For: 1.2.0
>
>
> It would be great if someone could create a step-by-step guide in creating a
> service and a client, instead of just adding an example in the manual. What I
> mean is an example which is gradually built from the most basic step into a
> really advanced implimentation.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
