参与W3C HTML5兼容性测试指南

This page explains how to participate in the W3C HTML5 test suite effort. This effort is managed by the HTML5 test suite task force, part of the HTML Working Group. 

There are a number of ways to participate. We welcome contributions of new test cases. The more tests we have, the faster we can improve interoperability among Web browsers.

If you wish to join the test suite task force, contact Philippe Le Hégaret <plh@w3.org> but you're most likely interest in joining the mailing list (see below).

==Status==

The HTML WG tests are developed in the W3C's Github 'Web Platform Tests' [https://github.com/w3c/web-platform-tests repository].  The test suite is now organized by sections of the HTML5 specification rather than by features.  For example 'Parser' tests are located in the 'syntax/parsing' folder which maps to section 8 'The HTML Syntax/8.1 Parsing Html dcouments' of the [http://www.w3.org/TR/html5/ HTML5] specification.<br><br>

Github has a master branch which hosts many tests beyond HTML WG tests, for example WebApp WG tests.  Though when a spec reaches CR the tests that apply to that specification are moved into the 'CR' branch from the 'Master' branch.  This effectively means for the HTML5 CR test suite will exists in the 'CR' branch.  Test for HTML5.1 would exist in the 'Master' branch, until it also reaches 'CR'.<br><br>

Tests that checked into our repository are replicated to [http://www.w3c-test.org/html/ w3c-test.org]. You can use the [http://w3c-test.org/tools/runner/index.html test runner] to see results. See also the [https://github.com/w3c/web-platform-tests#readme README on github] for more options.

During the April 2013 F2F the WG identified areas of the spec that need tests.  This work has been [http://www.w3.org/html/wg/tests-cr-exit.html documented by Robin].  Though the group is always open to accept test for any specification.  We do want to encourage people to submit tests to the areas that have been identified by the group as 'Requires Testing' rather than areas that have been identified as 'Consider Interoperable'.  Of course we also encourage tests that demonstrate and area is not 'Consider Interoperable' and by doing so we will update our documentation.<br>

==Discussion==
* The task force mailing list is public-html-testsuite@w3.org ([http://lists.w3.org/Archives/Public/public-html-testsuite/ archive])
* [[#Conference Calls]] (held every two weeks)

==HTML5 Test Coverage Analysis==
* The [http://www.w3.org/wiki/Testing/Test_Management_TF/HTML5_Test_Coverage_Analysis HTML5 Test Coverage Analysis] conducted by task force is [http://www.w3.org/wiki/Testing/Test_Management_TF/HTML5_Test_Coverage_Analysis here]

== Writing Tests ==

See the [http://testthewebforward.org/docs/ Guidelines for authoring tests].

== Reviewing Tests ==

We have several [https://github.com/w3c/web-platform-tests/issues?labels=wg-html&state=open pull requests] that need reviews!