Publishing a human-oriented service-description ?

[Paul Libbrecht <pa...@activemath.org>]

Hi List,

The development of a web-service that could be used by many passes 
through the publication of a human-readable description of the service, 
and maybe of a whole process.

How do people here publish their description to their friends, except 
for sending an email ?
Is there any usage of, maybe, xdoclet ?
Is there space in WSDL for human comments and tools to produce a 
documentation?

thanks

paul

RE: Publishing a human-oriented service-description ?

[Brian Jackson <Br...@zedak.com>]

Maybe WSDLdoc is what you are looking for?
http://www.bluetetra.com/wsdldoc/

Brian

-----Original Message-----
From: Ivan Aguirre [mailto:ivan.aguirre@gmail.com] 
Sent: Wednesday, November 10, 2004 10:51 AM
To: axis-user@ws.apache.org
Subject: Re: Publishing a human-oriented service-description ?

> How do people here publish their description to their friends, except
> for sending an email ?

One of the goals of Web Services is to be a easy way to provide
interoperable services across WEB. A read a lot of articles discussing
this goal is possible to be achieved, but not in a easy way....

It would be nice a human-readable WS description, the one we have -
WSDL, it's not so much readable... maybe if WSDL have some elements
with descriptions of operations and parameters it would be nice to
build some tool that generates a human-readable description.

Ivan de Aguirre
Brazil

Re: Publishing a human-oriented service-description ?

[Ivan Aguirre <iv...@gmail.com>]

> How do people here publish their description to their friends, except
> for sending an email ?

One of the goals of Web Services is to be a easy way to provide
interoperable services across WEB. A read a lot of articles discussing
this goal is possible to be achieved, but not in a easy way....

It would be nice a human-readable WS description, the one we have -
WSDL, it's not so much readable... maybe if WSDL have some elements
with descriptions of operations and parameters it would be nice to
build some tool that generates a human-readable description.

Ivan de Aguirre
Brazil