Forum Discussion

alibaba82's avatar
alibaba82
Super Contributor
16 years ago

wsdl documentation improvement

Hello,
I looked at the WSDL documentation feature and it is very useful. I was wondering if there would be a possiblity to add some additional bells and whistles.

would it be possible to add some user generated comments to different parts of the WSDL. Maybe a 'documentation' tab in the interfaces sections would be useful.

1. I would like have some custom message for each of the operations of the WSDL. so if I have a method 'register device' I can write what this method does so that it comes up somewhere when I generate the documentation via soapUI.

2. These optional comments would also be nice for each of the elements. For instance I have a element called email. I would like to have comments next to it that say that valid values are a-zA-Z...

3. A section to have 'additional comments' for each method. A user can defines custom messages such as
pre-conditions: how to invoke the services, error conditions, etc.

4. Also an option to include/exclude 'wsdl content' since the customer might already have the wsdl.

5. option to generate the documentation in pdf.


THanks

Ali