2002/ws/desc/test-suite faq.html,NONE,1.1

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