mirror of
https://github.com/servo/servo.git
synced 2025-08-07 14:35:33 +01:00
Update web-platform-tests to revision 0d318188757a9c996e20b82db201fd04de5aa255
This commit is contained in:
parent
b2a5225831
commit
1a81b18b9f
12321 changed files with 544385 additions and 6 deletions
65
tests/wpt/web-platform-tests/docs/css-naming.md
Normal file
65
tests/wpt/web-platform-tests/docs/css-naming.md
Normal file
|
@ -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.
|
Loading…
Add table
Add a link
Reference in a new issue