My two cents about level 0.
I think what you are saying would be useful explaining what webservices are, but probably
most non-expert users need something clarifying what web service are not. I mean,
simplifying a lot of course, something like "web service are not simple xml exchange,
are not xml to parse with proprietary sw or read by human" and so on.
Another important thing to consider at this level is the target of the docs. Readers would
be programmers, but probably also decision maker, IT manager, and maybe QA people who want
to understand what they are using. Mainly IT manager (or better people who decide budget
;) ) is an interesting target to get attention and to drive to decide if ws is good for
their project. It's also important at this level readers can get the idea and can
decide IF ws is a good solution for their environment.
IOW you have to inform and evangelize, not to persuade to use ws technology. When readers
would take the decision you would have to persuade them to use JBoss stack instead of any
others of course, but it is a step forward :).
hoping it might help
View the original post :
http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4095797#...
Reply to the post :
http://www.jboss.com/index.html?module=bb&op=posting&mode=reply&a...