Re: [soapbuilders] WSDL documentation - where best for interop for tools
- Hello Alan,
Here is the WASP's way of mapping wsdl->java and interpretting comments:
* java interface - generated from portType, so that
portType/documentation is the
documentation element used for interface's javadoc.
* method - generated from portType/operation, so that
is the documentation element used for method's javadoc.
Alan Kent wrote:
> Not sure the best place to post this question, so I will express it--
> in terms of interoperability of toolkits and express it here! :-)
> If I have a WSDL file exposing an API, and I want to include
> documentation in that API for all the methods, for the different
> toolkits that do something with the documentation, where do they
> expect the <documentation> elements to be?
> WSDL allows <wsdl:documentation> elements all over the place.
> Where do current toolkits actually look? Is there a practice
> that different vendors all follow? (eg: WASP seems to have a go
> at inserting the documentation as comments before all the Java
> methods it generates in interface definitions.)
Senior Architect, Systinet (formerly Idoox)