Contributing to the CSS Test Suites

The tests are intended to be released under both the W3C Document License and the BSD 3-clause license, so unless you represent a W3C Member, you must give your explicit permission for us to use your contributions under these licenses.

How to License Your Contribution

To give us permission to distribute your contribution under these two licenses, you need to fill out W3C's license grant form (unless you or your company is a member of the CSS Working Group, in which case you're covered already).

How to Submit a New Test

First, send us permission to use the test as described above.

You can either submit tests into the test repository yourself (see below), or you can send it as a link or attachment to public-css-testsuite@w3.org and ask someone else to submit it. If you are contributing tests for CSS2.1, you can also contact Gérard Talbot for assistance.

To obtain write access to the repository, log in to Shepherd and submit a request to modify assets on the Repository Access page. You will receive an email letting you know when access has been granted. We will set up a submission folder for you in the test repository. If you don't already have an account on Shepherd, you can register directly in Shepherd. Note that this wiki and Shepherd use the same accounts, so if you have an account here, you already have an account on Shepherd too.

To submit a test, simply add it to the submitted folder in your contributor directory and push your changes to https://hg.csswg.org/test. It will show up in Shepherd, our test-tracking system. You can use the incoming folder in your contributor directory as scratch space. See How to use Mercurial.

How to Report a Problem in the Test Suite

If you believe the issue needs further discussion, if it affects a large number of tests, or the test suite in question is not loaded into Shepherd (e.g. Media Queries), post to public-css-testsuite@w3.org describing the problem.