Hi,

I have a suggestion ;-)
In wsdl files you can specifiy documentation information which can be added to 
multiple elements (services, operations...).
If you generate your wsdl file starting on java side, you can add the 
information to the deployment files and it will be added to the wsdl while 
generation. 

After you added the information you can generate html files looking like 
javadoc for your wsdl. There are at least two tools (called wsdldoc) which can 
generate such documentations. I think http://www.bluetetra.com/ provides a 
solution and in the ettk package from ibm 
http://www.alphaworks.ibm.com/tech/ettkws theres an wsdldoc too.

best regards
Dominik

p.s.: Unfortunately the jsr181 annotation specification doesn't care about the 
documentation tag and so many libs using annos either





> -----Ursprüngliche Nachricht-----
> Von: [email protected]
> Gesendet: 21.03.06 23:18:53
> An: <[email protected]>
> Betreff: Auto generate documentation?  E.g. javadoc-like for webservices?


> 
> I'm using axis 1.3 on java.
> 
> Is there a way to autogenerate documentation for the service, and its method
> apis?
> 
> E.g. I'm thinking of somehthing like javadoc, but javadoc output is too java
> centric.
> 
> I'm thinking it would be useful to have the documentation info inside the
> code, ala javadoc, but the tool's output would be "platform" agnostic.  
> 
> Anything out there doing this already? (before I invent it.)
> 
> Thanks
> 
> Jeff
> 
> 


______________________________________________________________
Verschicken Sie romantische, coole und witzige Bilder per SMS!
Jetzt bei WEB.DE FreeMail: http://f.web.de/?mc=021193

Reply via email to