Re: documentation generated from .wsdl

Arthur Ryman <[email protected]> Fri, 5 Oct 2007 16:08:19 -0400
Newsgroups gmane.comp.web.services.description
Message-ID <OF877DFEDC.1C6390A2-ON8525736B.006D68D8-8525736B.006EA0F2@ca.ibm.com>
This is a multipart message in MIME format.
--=_alternative 006DF7098525736B_=
Content-Type: text/plain; charset="US-ASCII"

Tomi,

I see this is for WSDL 1.1. Have you thought of supporting WSDL 2.0? If 
you want to contribute your code, maybe the Apache Woden project [1] could 
provide a home. 

Another thought is to leverage the WSDL 2.0 Component Model Interchange 
format [2] - an XML format that combines the content of multiple WSDL 2.0 
and XSD files (via import and include) into a single file. This format is 
used in the Test Suit and is implemented by Woden.

[1] http://incubator.apache.org/woden/
[2] http://dev.w3.org/cvsweb/2002/ws/desc/test-suite/interchange/

Arthur Ryman, PhD, AoT, DE
Process and Portfolio Management, Rational Division

phone: +1-905-413-3077, TL 969-3077
assistant: +1-905-413-3831 (T/L: 318-8867)
fax: +1-905-413-4920, TL 969-4920
mobile: +1-416-939-5063, text: [email protected]



tomi vanek <[email protected]> 
Sent by: [email protected]
10/04/2007 10:22 AM

To
[email protected]
cc

Subject
Re: documentation generated from .wsdl






Michael Potter-3 wrote:
I have a need to document our webservices in a format usable by 
non-technical users. 
Maybe you could find useful my tool for WSDL documentation generation: the 
wsdl-viewer.xsl (http://tomi.vanek.sk/index.php?page=wsdl-viewer). This is 
just an XSLT 1.0 transformation that can run in any browser. The 
transformation converts WSDL into easier understandable HTML format. You 
can create the documentation either with batch processing (i.e. by ANT 
script), or simply by adding a processing instruction into WSDL, so by 
opening the WSDL in a browser the XML will be instantly converted into 
HTML. 
View this message in context: Re: documentation generated from .wsdl
Sent from the w3.org - www-ws-desc mailing list archive at Nabble.com.

--=_alternative 006DF7098525736B_=
Content-Type: text/html; charset="US-ASCII"


<br><font size=2 face="sans-serif">Tomi,</font>
<br>
<br><font size=2 face="sans-serif">I see this is for WSDL 1.1. Have you
thought of supporting WSDL 2.0? If you want to contribute your code, maybe
the Apache Woden project [1] could provide a home. </font>
<br>
<br><font size=2 face="sans-serif">Another thought is to leverage the WSDL
2.0 Component Model Interchange format [2] - an XML format that combines
the content of multiple WSDL 2.0 and XSD files (via import and include)
into a single file. This format is used in the Test Suit and is implemented
by Woden.</font>
<br>
<br><font size=2 face="sans-serif">[1] http://incubator.apache.org/woden/</font>
<br><font size=2 face="sans-serif">[2] http://dev.w3.org/cvsweb/2002/ws/desc/test-suite/interchange/</font>
<br>
<br><font size=2 face="sans-serif">Arthur Ryman, PhD, AoT, DE<br>
Process and Portfolio Management, Rational Division<br>
<br>
phone: +1-905-413-3077, TL 969-3077<br>
assistant: +1-905-413-3831 (T/L: 318-8867)<br>
fax: +1-905-413-4920, TL 969-4920<br>
mobile: +1-416-939-5063, text: [email protected]</font>
<br>
<br>
<br>
<table width=100%>
<tr valign=top>
<td width=40%><font size=1 face="sans-serif"><b>tomi vanek &lt;[email protected]&gt;</b>
</font>
<br><font size=1 face="sans-serif">Sent by: [email protected]</font>
<p><font size=1 face="sans-serif">10/04/2007 10:22 AM</font>
<td width=59%>
<table width=100%>
<tr valign=top>
<td>
<div align=right><font size=1 face="sans-serif">To</font></div>
<td><font size=1 face="sans-serif">[email protected]</font>
<tr valign=top>
<td>
<div align=right><font size=1 face="sans-serif">cc</font></div>
<td>
<tr valign=top>
<td>
<div align=right><font size=1 face="sans-serif">Subject</font></div>
<td><font size=1 face="sans-serif">Re: documentation generated from .wsdl</font></table>
<br>
<table>
<tr valign=top>
<td>
<td></table>
<br></table>
<br>
<br>
<br><font size=3><b>Michael Potter-3 wrote:</b></font>
<br><font size=3>I have a need to document our webservices in a format
usable by non-technical users. </font>
<br><font size=3>Maybe you could find useful my tool for WSDL documentation
generation: the <b>wsdl-viewer.xsl</b> (</font><a href="http://tomi.vanek.sk/index.php?page=wsdl-viewer" target=_top><font size=3 color=#800080><u>http://tomi.vanek.sk/index.php?page=wsdl-viewer</u></font></a><font size=3>).
This is just an XSLT 1.0 transformation that can run in any browser. The
transformation converts WSDL into easier understandable HTML format. You
can create the documentation either with batch processing (i.e. by ANT
script), or simply by adding a processing instruction into WSDL, so by
opening the WSDL in a browser the XML will be instantly converted into
HTML. <br>
</font>
<hr><font size=3>View this message in context: </font><a href="http://www.nabble.com/documentation-generated-from-.wsdl-tf4245751.html#a13040893"><font size=3 color=blue><u>Re:
documentation generated from .wsdl</u></font></a><font size=3><br>
Sent from the </font><a href="http://www.nabble.com/w3.org---www-ws-desc-f11747.html"><font size=3 color=blue><u>w3.org
- www-ws-desc mailing list archive</u></font></a><font size=3> at Nabble.com.</font>
<br>
--=_alternative 006DF7098525736B_=--