documentation generated from .wsdl

wsdl list,

I have a need to document our webservices in a format usable by
non-technical users.

What I have in mind is some additional markup in my .wsdl files that I
will filter and use to generate .pdf/.html files.  This would be done in the
spirit of javadoc for java and pod for perl.

My questions are:
1) Has anyone already done such a thing?
2) Is there a standard way to do that?

I am guessing that such a tool would use the
<xs:annotation>
<xs:documentation xml:lang="en">
<wsdl:documentation>
tags.

To be useful the tool would need to do more than just read those tags.
 Much like javadoc requires the comments in java to have a particular
format, the tool would have to have the mentioned tags to have a
specific format.

I apologize if this is not the correct forum for such a question.  If
you could point me to a proper forum I would appreciate it.

The context of this question is that I have 1200 webservices and would
like to produce documentation that is suitable for a sales situation.
I would like to maintain that documentation in the .wsdl file or other
source code so that it would stay up-to-date.

--
Michael Potter

Received on Thursday, 9 August 2007 23:06:24 UTC