W3C CSS Test Suite Repository
-----------------------------
 
This repository contains top level directories for all of CSS specs for
which we currently have tests. Place tests in the appropriate directory based
on the first rel="help" link in the test. If you are writing tests for a spec
and it doesn't yet have a directory here, feel free to create it.

There are a few directories that do not map to specifications:

support/ contains common image files to which many of the tests link in
this location

tools/ is random scripts that may be useful when administering tests.

vendor-imports/ is where third parties may import their tests that originate
and are maintained in an external repo. Files in this directory should
never be modified in this repo, but should go through the vendor's process
to be imported here.

work-in-progress/ is a legacy directory that contains all the work that was
once submitted to the repo, but was not yet ready for review. Since the CSSWG
has adopted the GitHub pull request process, no new files should be landed here.
The subdirectories here are named by test author or contributing organization.

Linking Your Tests to Specifications
-----------------------------------

In addition to placing your tests in the appropriate directory in this repository,
you must also include at least one specification link in the test metadata,
following [these guidelines][speclinks].

For CSS tests, you must also be sure you’re linking to a specific level of the spec,
generally the first level where the feature being tested is defined. Where possible,
it’s preferable to link to the official version of the spec, which will start with
http://www.w3.org/TR/. This can usually be found as the ‘Latest version’ link in the
spec itself and will include the level of the spec in the URL. For example, the proper
link to level 1 of the CSS Flexbox spec is:

http://www.w3.org/TR/css-flexbox-1/#RELEVANT_SECTION

When testing features not yet available in an official draft, link to the appropriate
Editor’s Draft found at http://dev.w3.org/csswg/. Be sure to include the level of the
specification in the link. For example, the proper link to the CSS Flexbox Level 1
Editor’s Draft is:

http://dev.w3.org/csswg/css-flexbox-1/#RELEVANT_SECTION

Contributing
-------------

Absolutely everyone is welcome (and even encouraged) to contribute to test
development, so long as you fulfill the contribution requirements detailed
in the [Contributing Guidelines][contributing]. No test is too small or too
simple, especially if it corresponds to something for which you've noted an
interoperability bug in a browser.

Write Access
------------

This section only applies if you have cloned the repository from
Mercurial. If you've cloned it from GitHub, which is a mirror of
the canonical Mercurial repo, you can submit your tests via a [pull request][github101].

To gain write access to this Mercurial repository, sign up for an account
on the CSS Test Suite Manager (aka Shepherd) at:
https://test.csswg.org/shepherd/register
and then submit a request on the Repository Access page at:
https://test.csswg.org/shepherd/account/access/

You will be notified by email when your request is processed.

Please note that although we will grant write access directly to the Mercurial
repo, it is strongly advised to use GitHub for test submissions to enable
reviewers to use its built-in review tools. Direct submissions to Mercurial
should be limited to administrative or housekeeping tasks, very minor changes
that don't require a review, or from advanced users of the system.

[contributing]: https://github.com/rhauck/csswg-test/blob/master/CONTRIBUTING.md
[github101]: http://testthewebforward.org/docs/github-101.html
[speclinks]: http://testthewebforward.org/docs/test-templates.html#specification-links
Icon  Name                    Last modified      Size  Description
[DIR] Parent Directory - [DIR] compositing-1/ 01-Aug-2014 16:53 - [DIR] css-align-3/ 11-Jun-2014 12:24 - [DIR] css-animations-1/ 07-Aug-2014 18:30 - [DIR] css-backgrounds-3/ 24-Oct-2014 00:03 - [DIR] css-box-3/ 07-Aug-2014 18:30 - [DIR] css-break-3/ 30-May-2014 00:04 - [DIR] css-color-3/ 30-May-2014 00:04 - [DIR] css-conditional-3/ 30-May-2014 00:04 - [DIR] css-counter-styles-3/ 30-May-2014 00:04 - [DIR] css-exclusions-1/ 30-May-2014 00:04 - [DIR] css-flexbox-1/ 24-Oct-2014 00:03 - [DIR] css-fonts-3/ 06-Oct-2014 05:04 - [DIR] css-gcpm-3/ 08-Aug-2014 08:39 - [DIR] css-grid-1/ 05-Aug-2014 17:01 - [DIR] css-images-3/ 15-Sep-2014 08:08 - [DIR] css-lists-3/ 30-May-2014 00:04 - [DIR] css-masking-1/ 23-Oct-2014 00:03 - [DIR] css-multicol-1/ 05-Aug-2014 17:16 - [DIR] css-namespaces-1/ 06-Aug-2014 11:50 - [DIR] css-page-3/ 15-Sep-2014 08:04 - [DIR] css-regions-1/ 01-Aug-2014 16:53 - [DIR] css-ruby-1/ 30-May-2014 00:04 - [DIR] css-shapes-1/ 19-Aug-2014 00:03 - [DIR] css-speech-1/ 30-May-2014 00:04 - [DIR] css-style-attr-1/ 24-Oct-2014 00:03 - [DIR] css-syntax-3/ 30-May-2014 00:04 - [DIR] css-tables-3/ 30-May-2014 00:04 - [DIR] css-text-3/ 05-Aug-2014 14:24 - [DIR] css-text-decor-3/ 01-Aug-2014 16:53 - [DIR] css-transforms-1/ 07-Aug-2014 18:30 - [DIR] css-transitions-1/ 11-Jun-2014 12:24 - [DIR] css-ui-3/ 11-Jun-2014 12:24 - [DIR] css-values-3/ 23-Aug-2014 10:37 - [DIR] css-variables-1/ 01-Aug-2014 16:53 - [DIR] css-writing-modes-3/ 24-Oct-2014 00:03 - [DIR] css1/ 30-May-2014 00:04 - [DIR] css21/ 01-Aug-2014 16:53 - [DIR] cssom-1/ 30-May-2014 00:04 - [DIR] cssom-view-1/ 18-Jun-2014 16:27 - [DIR] filters-1/ 05-Aug-2014 17:28 - [DIR] fonts/ 30-May-2014 00:04 - [DIR] geometry-1/ 18-Jun-2014 16:20 - [DIR] mediaqueries-3/ 30-May-2014 00:04 - [DIR] selectors-3/ 30-May-2014 00:04 - [DIR] selectors-4/ 11-Jun-2014 12:24 - [DIR] support/ 30-May-2014 00:04 - [DIR] tools/ 21-Aug-2014 11:09 - [DIR] vendor-imports/ 30-May-2014 00:04 - [DIR] work-in-progress/ 03-Sep-2014 00:03 - [   ] CONTRIBUTING.md 02-Aug-2013 11:57 1.5K [   ] LICENSE 02-Aug-2013 11:57 144 [TXT] filename-list.html 24-Oct-2014 00:03 2.8M CSS Tests by Filename [TXT] filename-list.txt 24-Oct-2014 00:03 1.5M [TXT] parse-errors.txt 24-Oct-2014 00:03 12M