- From: Arthur Ryman via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 17 Oct 2006 14:16:45 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/test-suite In directory hutz:/tmp/cvs-serv28072/test-suite Added Files: faq.html Log Message: Initial commit of test suite faq. --- NEW FILE: faq.html --- <html> <head> <title>W3C WSDL 2.0 Test Suite FAQ</title> <link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/base.css" /> </head> <body> <h1>W3C WSDL 2.0 Test Suite FAQ</h1> <h2>Table of Contents</h2> <ul> <li><a href="#where">Where can I find the test suite?</a></li> <li><a href="#what">What is in the test suite?</a></li> <li><a href="#how">How do I contribute a test case?</a></li> </ul> <h2><a name="where">Where can I find the test suite?</a></h2> <p>The <a href="http://dev.w3.org/cvsweb/2002/ws/desc/test-suite/">test suite</a> is located in the Web Service Description Working Group area of the W3C CVS repository.</p> <table> <tr> <th align="left">Host:</th> <td>dev.w3.org</td> </tr> <tr> <th align="left">Repository path:</th> <td>/sources/public</td> </tr> <tr> <th align="left">Directory:</th> <td>/2002/ws/desc/test-suite</td> </tr> </table> <h2><a name="what">What is in the test suite?</a></h2> <p>The test suite contains test cases and reports. See <a href="http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/test-suite/index.html">W3C WSDL 2.0 Test Suite</a> for a description.</p> <p>The most common kind of test case is a <em>document</em> test case. This consists of a main WSDL 2.0 document plus any other WSDL 2.0 or XSD documents that it references. The document test cases are stored in the <a href="http://dev.w3.org/cvsweb/2002/ws/desc/test-suite/documents/">documents</a> directory of the test suite.</p> <p>All WSDL 2.0 documents in the test suite must be <a href="http://www.w3.org/2006/01/wsdl/">schema</a> valid, that is, we are not interested in test cases that violate the schema because this type of error can be easily checked by a validating XML parser. Instead, we are interested in two types of WSDL 2.0 document, which we refer to as <em><a href="http://dev.w3.org/cvsweb/2002/ws/desc/test-suite/documents/good/">good</a></em> or <em><a href="http://dev.w3.org/cvsweb/2002/ws/desc/test-suite/documents/bad/">bad</a></em> documents. A good document satisfies all the rules defined by the WSDL 2.0 specification. We are interested in building up a suite of good documents that cover all aspects of the specification.</p> <p>In contrast, a bad document violates at least one rule. The rules defined by the specification are referred to as testable assertions and are marked up in the specification and summarized in appendices of <a href="http://www.w3.org/TR/wsdl20/#assertionsummary">Part 1</a> and <a href="http://www.w3.org/TR/wsdl20-adjuncts/#assertionsummary">Part 2</a>. We are interested in building up a suite of bad documents that in total violate each testable assertion.</p> <h2><a name="how">How do I contribute a test case?</a></h2> <p><a href="http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/test-suite/index.html">W3C WSDL 2.0 Test Suite</a> contains brief instructions for contributing test cases. These are expanded here.</p> <p>The simplest way to contribute a test case is to send an email describing the test case to the Working Group public mailing list, <a href="mailto:www-ws-desc@w3.org">www-ws-desc@w3.org</a> and attach a WSDL 2.0 document to it. However, the preferred way to contribute a test case is to generate a CVS patch for it. Check out the test suite from CVS, add your test case, generate a CVS patch, and attach that to your email instead of just the WSDL 2.0 document.</p> </body> </html>
Received on Tuesday, 17 October 2006 14:16:55 UTC