- From: Jean-Jacques Moreau via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 28 Feb 2005 17:23:41 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20
In directory hutz:/tmp/cvs-serv13377
Modified Files:
wsdl20.xml
Log Message:
ii) Added second note clarifying extensibility semantics.
Index: wsdl20.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20.xml,v
retrieving revision 1.180
retrieving revision 1.181
diff -C2 -d -r1.180 -r1.181
*** wsdl20.xml 28 Feb 2005 17:17:42 -0000 1.180
--- wsdl20.xml 28 Feb 2005 17:23:39 -0000 1.181
***************
*** 7314,7317 ****
--- 7314,7336 ----
Property.
</p>
+
+ <note><p>A key purpose of an extension is to formally indicate (i.e., in a
+ machine-processable way) that a particular feature or convention is
+ supported or required. This enables toolkits that understand the
+ extension to engage it automatically, while toolkits that do not yet
+ understand a required extension may be able to flag it to an operator
+ for manual support.</p>
+
+ <p>If a Web service requires the client to follow a particular convention
+ that is likely to be automatable in WSDL toolkits, then that convention
+ SHOULD be indicated in the WSDL document as a wsdl:required extension,
+ rather than just being conveyed out of band, even if that convention is
+ not currently implemented in WSDL toolkits.</p>
+
+ <p>This practice will help prevent interoperability problems that could
+ arise if one toolkit requires a particular convention that is not
+ indicated in the WSDL document, while another toolkit does not realize
+ that that convention is required. It will also help facilitate future
+ automatic processing by WSDL toolkits.</p></note>
<p>
***************
*** 8803,8806 ****
--- 8822,8832 ----
<td>20050228</td>
<td>JJM</td>
+ <td><loc href="http://lists.w3.org/Archives/Public/www-ws-desc/2005Feb/0006.html">X</loc> and
+ <loc href="http://lists.w3.org/Archives/Public/www-ws-desc/2004Dec/0022.html">Y</loc>:
+ Added note clarifying extensibility semantics.</td>
+ </tr>
+ <tr>
+ <td>20050228</td>
+ <td>JJM</td>
<td><loc href="http://lists.w3.org/Archives/Public/www-ws-desc/2005Feb/0006.html">X</loc>:
Added note clarifying extensibility semantics.</td>
Received on Monday, 28 February 2005 17:23:42 UTC