diff options
Diffstat (limited to 'tests/wpt/web-platform-tests/docs/css-naming.md')
m--------- | tests/wpt/web-platform-tests | 0 | ||||
-rw-r--r-- | tests/wpt/web-platform-tests/docs/css-naming.md | 65 |
2 files changed, 65 insertions, 0 deletions
diff --git a/tests/wpt/web-platform-tests b/tests/wpt/web-platform-tests deleted file mode 160000 -Subproject 29dfb8944e535d439ca94cf7d1b1d9138a8ad11 diff --git a/tests/wpt/web-platform-tests/docs/css-naming.md b/tests/wpt/web-platform-tests/docs/css-naming.md new file mode 100644 index 00000000000..9652b0b9ce1 --- /dev/null +++ b/tests/wpt/web-platform-tests/docs/css-naming.md @@ -0,0 +1,65 @@ +CSS tests require a specific naming convention. This is also a good, +but not mandatory, style to use for other tests. + +## File Name + +The file name format is ```test-topic-###.ext``` where ```test- +topic``` somewhat describes the test and ### is a zero-filled number +used to keep the file names unique. + +**test-topic** + +A short identifier that describes the test. The test-topic should +avoid conjunctions, articles, and prepositions. It is a file name, +not an English phrase: it should be as concise as possible. + +Examples: +``` + margin-collapsing-###.ext + border-solid-###.ext + float-clear-###.ext +``` + +**###** + +This is a zero-filled number used to keep the file names unique when +files have the same test-topic name. + +Note: The number format is limited to 999 cases. If you go over this +number it is recommended that you reevaluate your test-topic name. + +For example, in the case of margin-collapsing there are multiple +cases so each case could have the same test-topic but different +numbers: + +``` + margin-collapsing-001.xht + margin-collapsing-002.xht + margin-collapsing-003.xht +``` + +There may also be a letter affixed after the number, which can be +used to indicate variants of a test. + +For example, ```float-wrap-001l.xht``` and ```float-wrap-001r.xht``` +might be left and right variants of a float test. + +If tests using both the unsuffixed number and the suffixed number +exist, the suffixed tests must be subsets of the unsuffixed test. + +For example, if ```bidi-004``` and ```bidi-004a``` both exist, +```bidi-004a``` must be a subset of ```bidi-004```. + +If the unsuffixed test is strictly the union of the suffixed tests, +i.e. covers all aspects of the suffixed tests (such that a user agent +passing the unsuffixed test will, by design, pass all the suffixed +tests), then the unsuffixed test should be marked with the combo flag. + +If ```bidi-004a``` and ```bidi-004b``` cover all aspects of ```bidi- +004``` (except their interaction), then bidi-004 should be given the +combo flag. + +**ext** + +The file extension or format of the file, usually ```.xht``` for +test files. |