- From: Arthur Ryman <aryman@dev.w3.org>
- Date: Thu, 03 Feb 2005 21:38:18 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/test-suite
In directory hutz:/tmp/cvs-serv19890
Modified Files:
index.html
Log Message:
Added instructions for contributing test cases to index.html.
Index: index.html
===================================================================
RCS file: /sources/public/2002/ws/desc/test-suite/index.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** index.html 3 Feb 2005 14:36:52 -0000 1.2
--- index.html 3 Feb 2005 21:38:15 -0000 1.3
***************
*** 1,35 ****
<html>
<head>
! <title>examples</title>
</head>
<body>
! <h1>examples</h1>
<address>Arthur Ryman</address>
! <address>2004-09-01</address>
<p>
! This project shows how to validate example WSDL 2.0 documents using ant.
! The Primer will contain valid examples and may also include some invalid ones.
! We want to make sure that the valid examples are really valid, and that
! the invalid ones are invalid.
! Put valid examples in /examples/valid.
! Put invalid examples in /examples/invalid.
</p>
<p>
! The xmlcatalog directory contains the schemas for WSDL 2.0 (in /examples/xmlcatalog/wsdl)
! and XSD 1.0 (in /examples/xmlcatalog/xsd).
</p>
<p>
! Refer to the /examples/build.xml ant script.
! To validate the valid examples, run the 'valid' target.
! The 'valid' target will stop if it encounters an error since all these
! documents are supposed to be valid.
! To validate the invalid examples, run the 'invalid target.
! The 'invalid' target will report errors and keep going.
! Check the console output to make sure these are really invalid.
</p>
<p>
! The ant xmlvalidate task requires the xerces parser to validate xsd.
! Modify the xercesImpl property to point to where you installed xerces on your machine.
</p>
</body>
</html>
\ No newline at end of file
--- 1,75 ----
<html>
<head>
! <title>W3C WSDL 2.0 Test Suite</title>
</head>
<body>
! <h1>W3C WSDL 2.0 Test Suite</h1>
<address>Arthur Ryman</address>
! <address>2005-02-03</address>
! <h2>Introduction</h2>
<p>
! This directory contains the W3C WSDL 2.0 Test Suite.
! The purpose of this test suite is to provide a common set of test cases that can be used by any WSDL 2.0 implementation.
! The test cases are divided into <em>good</em> and <em>bad</em> buckets.
! The good test cases are correct examples of usage.
! Our goal is to have at least one good test case for each aspect of WSDL 2.0. For example, every XML element and attribute in WSDL 2.0
! should be present in at least one good test case.
! The bad test cases are incorrect examples of usage.
! Our goal is to have at least one bad example that violates each constraint or rule in WSDL 2.0. For example, every rule that cannot be
! expressed in the XML schema for WSDL 2.0 should be violated in at least one bad document.
</p>
<p>
! The structure of the Test Suite is described in
! <a href="TestSuiteContents.html"><em>Test Suite Contents</em></a>.
! The test suite is contained in the following subdirectories:
</p>
+ <ul>
+ <li><code>document</code> contains WSDL documents</li>
+ <li><code>messages</code> contains messages</li>
+ <li><code>exchanges</code> contains message exchanges</li>
+ </ul>
+ <h2>Validation</h2>
<p>
! All WSDL 2.0 documents in the test suite are required to be valid with respect to the normative XML schema for WSDL 2.0.
! There is little value in including non-valid documents, since any validating parser can check the schema rules.
! An <a href="http://ant.apache.org/">Ant</a> script is therefore provided to perform XML schema validation on all the WSDL documents.
! The <a href="http://xml.apache.org/xerces2-j/">Xerces</a> parser is used for this purpose.
! Override the Ant <code>${xercesImpl.jar}</code> property to point to where you installed Xerces on your machine.
</p>
<p>
! The <code>xmlcatalog</code> subdirectory contains the XML schemas for WSDL 2.0 and XSD 1.0.
! </p>
! <p>
! We are mainly concerned with test documents that violate rules that cannot be expressed in the XML schema.
! Such rules must be checked by validators, for example the Java WSDL validator that is being developed in the
! Eclipse
! <a href="http://www.eclipse.org/wsvt">Web Service Validation Tools</a> (WSVT) project,
! which is becoming part of the Eclipse <a href="http:www.eclipse.org/webtools">Web Tools Platform</a> (WTP) project.
! </p>
! <h2>Contributing Test Cases</h2>
! <p>
! The community is encouraged to contribute test cases.
! The best way to confirm your understanding of the specification is to contribute an illustrative test case.
! Test cases should be contributed by emailing them to the W3C Web Services Description Working Group
! <a href="mailto:www-ws-desc@w3.org">mailing list</a>.
! </p>
! <p>
! This directory is stored in the <a href="http://dev.w3.org/cvsweb/2002/ws/desc/test-suite/">W3C CVS repository</a>.
! CVS users are requested to email modifications or additions to the test suite as patches.
! Access CVS using the following parameters:
! </p>
! <ul>
! <li>host: <code>dev.w3.org</code></li>
! <li>repository path: <code>/sources/public</code></li>
! <li>connection type: <code>pserver</code></li>
! <li>user: <code>anonymous</code></li>
! <li>password: <code>anonymous</code></li>
! <li>project path: <code>/2002/ws/desc/test-suite</code></li>
! </ul>
! <p>
! Contributors who are looking for a convenient, free tool to access CVS and create patches can use
! <a href="http://www.eclipse.org">Eclipse</a>.
</p>
+
</body>
</html>
\ No newline at end of file
Received on Thursday, 3 February 2005 21:38:18 UTC