summaryrefslogtreecommitdiffstats
path: root/chromium/docs/website/site/layout-test-contest/index.md
blob: c49d7431c6664157d3a2c12f4f298105cfb5e8d5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
---
breadcrumbs: []
page_name: layout-test-contest
title: Layout Test Contest
---

## Why? Fix all test ordering issues so we can enable --order=random-seeded by default. Drive number of lines in test_expectations to 0 so it is easier to maintain. Win fame and prizes!

### Who? Everyone! Yes, you can participate even if you've never contributed to Blink before! In fact, this is the perfect way to get some Blink commits under your belt! You don't need to be a Google employee either.

### Dates: The contest will begin on 9/30 ~~and end on 10/20 at 11:59pm PST~~ extended to 10/27 at 11:59pm PST!!! All code must be submitted for review during these dates to be eligible.

### Scoring: Points will be awarded based on the tasks completed. Point values for each task are explained below. Each participant's score will be the sum of his or her points. See the [leaderboard](/layout-test-contest/layout-test-contest-leaderboard)!

### Winners & Prizes:

There are many chances to win! In addition to standard 1st, 2nd, 3rd Place,
there are additional prizes:

*   Cheetah: First person to 250 points. Start off the contest with a
            bang!
*   Top Reviewer: Awarded to the participant with the highest number of
            points from code reviews only. Show off your code review skillz!
*   Best Yak Shave: Awarded to the participant with the most ridiculous
            patch, or series of patches, required to solve a "simple" problem.
            Show your perseverance!
*   Top Slacker: Awarded to the participant with the highest number of
            points gained, who starts AFTER October 14, 11:59pm PST.

Winners will select a prize from a prize category. Any prize can be exchanged
for a **"Get out of gardening free pass!" - Priceless!**

#### 1st Prize: Awarded to the participant with the highest number of points.

**Your choice of:**

Indoor Sky Diving Party
for 12
<img alt="Vegas Indoor Skydiving Elvis"
src="http://media-cdn.tripadvisor.com/media/photo-s/01/ca/ea/7a/vegas-indoor-skydiving.jpg"
height=133 width=200>

[Kitchit Dinner
Party](http://www.kitchit.com/listings/late-summer-farmers-market-dinner)
for 8

[<img alt="image"
src="https://kitchit-static01.insnw.net/images/4453/Large/6215_1160623569817_1054627764_484055_6067109_n.jpg"
height=133
width=200>](https://kitchit-static01.insnw.net/images/4453/Large/6215_1160623569817_1054627764_484055_6067109_n.jpg)

Sennheiser HD 650 Headphones
<img alt="image"
src="http://ecx.images-amazon.com/images/I/81zggHtrqML._SY300_.jpg" height=200
width=142>

iRobot Roomba or Scooba
<img alt="image"
src="http://ecx.images-amazon.com/images/I/41kXrlCafUL._SX450_.jpg" height=140
width=200>

LG Electronics 50LN5400 50-Inch 1080p 120Hz LED-LCD HDTV with Smart Share
<img alt="image"
src="http://ecx.images-amazon.com/images/I/81M29eUuQgL._SX300_.jpg" height=175
width=200>

1982 Port Ellen 30yr Scotch
<img alt="1982 Port Ellen 30 Year Old "K&L Exclusive" Sovereign Single Barrel
Cask Strength Single Malt Whisky 750ml"
src="http://www.klwines.com/images/skus/1117203l.jpg" height=200 width=83>

#### 2nd Prize: Awarded to the participant with the second highest number of points.

**Your choice of:**

Indoor Sky Diving Party
for 5
<img alt="Vegas Indoor Skydiving Elvis"
src="http://media-cdn.tripadvisor.com/media/photo-s/01/ca/ea/7a/vegas-indoor-skydiving.jpg"
height=133 width=200>

[Kitchit Dinner
Party](http://www.kitchit.com/listings/late-summer-farmers-market-dinner)
for 4
<img alt="image"
src="https://kitchit-static01.insnw.net/images/4453/Large/6215_1160623569817_1054627764_484055_6067109_n.jpg"
height=133 width=200>

Nexus 7 32G
<img alt="image"
src="http://ecx.images-amazon.com/images/I/71mCTJlJwGL._SY679_.jpg" height=200
width=140>

Sonos Play 3
<img alt="image"
src="http://ecx.images-amazon.com/images/I/81VEXB6fJwL._SX522_.jpg" height=185
width=200>

Breville Smart Oven Convection Toaster Oven with Element IQ
<img alt="image"
src="http://ecx.images-amazon.com/images/I/41W8PMvH9FL._SX450_.jpg" height=120
width=200>

1996 Opus One Napa Valley Proprietary Red
<img alt="1996 Opus One Napa Valley Proprietary Red"
src="http://www.klwines.com/images/skus/301229l.jpg" height=200 width=83>

#### 3rd Prize: Awarded to the participant with the third highest number of points.

#### Cheetah: First person to 250 points. Start off the contest with a bang!

#### Top Reviewer: Awarded to the participant with the highest number of points from code reviews only. Show off your code review skillz!

**Top Slacker: Awarded to the participant with the highest number of points
gained, who starts AFTER October 14, 11:59pm PST.**

**Your choice of:**

[Kitchit Dinner
Party](http://www.google.com/url?q=http%3A%2F%2Fwww.kitchit.com%2Flistings%2Flate-summer-farmers-market-dinner&sa=D&sntz=1&usg=AFrqEzeeon2ePMRBRFaHc6luP02HSn0e3w)
for 2
<img alt="image"
src="https://kitchit-static01.insnw.net/images/4453/Large/6215_1160623569817_1054627764_484055_6067109_n.jpg"
height=133 width=200>

SodaStream Pure w/ Soda Starter Kit
<table>
<tr>
<td><img alt="Pure - Soda Starter Kit " src="http://www.sodastreamusa.com/Assets/ProductImages/pure_soda_starter_black.jpg" height=200 width=200></td>
</tr>
</table>

Sennheiser HD 558 Headphones
<img alt="image"
src="http://ecx.images-amazon.com/images/I/41ljcZIdgGL._SY300_.jpg" height=200
width=153>

Kindle Paperwhite, 3G
<img alt="image"
src="http://g-ecx.images-amazon.com/images/G/01/kindle/dp/2012/KC/technical._V376689304_.jpg"
height=200 width=189>

Breville Compact Smart Oven Toaster Oven with Element IQ
<img alt="image"
src="http://ecx.images-amazon.com/images/I/41AU85%2BnMFL._SX450_.jpg" height=128
width=200>

Macallan 18 year old Single Malt
<img alt="Macallan 18 year old Single Malt Whisky 750ml"
src="http://www.klwines.com/images/skus/620010l.jpg" height=200 width=83>

#### Best [Yak Shave](http://en.wiktionary.org/wiki/yak_shaving): Awarded to the participant with the most ridiculous patch, or series of patches, required to solve a "simple" problem.

**Your very own Shaving Yak Action Figure!**

<img alt="image"
src="http://ecx.images-amazon.com/images/I/41K5N9X899L._SX385_.jpg" height=200
width=180> +

#### **Your choice of:**

**Indoor Sky Diving**
**for 2**
**<img alt="Vegas Indoor Skydiving Elvis"
src="http://media-cdn.tripadvisor.com/media/photo-s/01/ca/ea/7a/vegas-indoor-skydiving.jpg"
height=133 width=200>**

**SodaStream Genesis w/ Soda Starter Kit**
**<table>**
**<tr>**

**<td><img alt="Genesis - Soda Starter Kit "
src="http://www.sodastreamusa.com/Assets/ProductImages/genesis_soda_starter_black.jpg"
height=200 width=200></td>**

**</tr>**
**</table>**

**Sennheiser HD-280 PRO Headphones**
**<img alt="image"
src="http://ecx.images-amazon.com/images/I/413dm8SG1nL._SY300_.jpg" height=200
width=153>**

**Kindle Paperwhite, Wi-Fi**
**<img alt="image"
src="http://g-ecx.images-amazon.com/images/G/01/kindle/dp/2012/KC/technical._V376689304_.jpg"
height=200 width=189>**

**AeroGarden Classic 7-Pod with Gourmet Herb Seed Kit**
**<img alt="image"
src="http://ecx.images-amazon.com/images/I/51nhCytPscL._SY450_.jpg" height=200
width=184>**

**2003 Dom Perignon**
**<img alt="2003 Moet & Chandon "Dom Pérignon" Brut Champagne"
src="http://www.klwines.com/images/skus/1089853l.jpg" height=200 width=83>**

#### \*For non-MTV based winners, suitable equivalent prizes will be awarded if necessary.

### How to Participate

1.  Complete any of the tasks below.
2.  For each task, submit your participation info using [this
            form](https://docs.google.com/a/chromium.org/forms/d/1MHJ_WC-niQkhvnyofWkEl-zaRUZpz7fxrLkllDKR-p8/viewform).
            Sorry, any task completed, but not submitted in this manner, will
            not be eligible.
3.  Profit!

## Points

Points are not additive. Each patch can only apply to one category.

#### C++ or Python change fix to endemic test flakiness

*   Points: 50
*   Examples: reset some state between test runs or fix a race condition
            in run-webkit-tests.

#### Fix a line or flaky test in TestExpectations that crashes

*   Points: 5/line
*   Includes \[ Pass Crash \] lines.

**Fix a line or flaky test in TestExpectations that doesn't crash**

*   Points: 3/line

#### Remove a line from TestExpectations (with no other changes, whitespace and comment lines do \*not\* count)

*   Points: 1/line
*   This is for TestExpectations-only changes. If you made a
            non-TestExpectations-only change that fixed more tests than you
            realized, you can still submit a TestExpectations-only change for 3
            points per line.

#### Code review a C++/Python change

*   Points: 3
*   Again, pure TestExpectations-only changes don't count.
*   It's the reviewer's responsibility to fill out the form above.

## How To

Here are some ideas for ways to identify test flakiness/ordering issues.

### 1. Fix filed test ordering bugs (good way to find C++ endemic flakiness issues!!)

<https://code.google.com/p/chromium/issues/list?q=label:LayoutTestOrdering>

### 2. Run tests in a random order and diagnose failures

1.  Run "run-webkit-tests --order=random --no-retry".
2.  Run "./Tools/Scripts/print-test-ordering" and save the output to a
            file. This outputs the tests run in the order they were run on each
            content_shell instance.
3.  For each test that fails:
    1.  Find which worker it ran on.
    2.  Create a file that contains only the tests run on that worker in
                the same order as in your saved output file.
    3.  run-webkit-tests --child-processes=1 --order=none
                --test-list=path/to/file/from/previous/step
    4.  If the test doesn't fail here, then the test itself is probably
                just flaky. If it does, remove some lines from the file created
                in step 2.2 and repeat step 3. Continue repeating until you've
                found the dependency. If the test fails when run by itself, but
                passes on the bots, that means that it depends on another test
                to pass. In this case, you need to generate the list of tests
                run by "run-webkit-tests --order=natural" and repeat this
                process to find which test causes the test in question to
                \*pass\* (e.g. [crbug.com/262793](http://crbug.com/262793)).
    5.  File a bug and give it the LayoutTestOrdering label, e.g.
                [crbug.com/262787](http://crbug.com/262787) or
                [crbug.com/262791](http://crbug.com/262791)

### 3. Run tests in isolation

Run "run-webkit-tests --batch-size 1 --no-retry". This starts up a new
content_shell instance for each test. Tests that fail when run in isolation but
pass when run as part of the full test suite represent some state that we're not
properly resetting between test runs or some state that we're not properly
setting when starting up content_shell. You might want to run with
--timeout-ms=60000 to weed out tests that timeout due to waiting on
content_shell startup time.

### 4. Diagnose especially flaky tests

1.  Load the[ flakiness
            dashboard](http://test-results.appspot.com/dashboards/overview.html#group=%40ToT%20Blink&flipCount=12)
2.  Tweak the flakiness threshold to the desired level of flakiness.
3.  Click on "layout-tests" to get that list of flaky tests.
4.  Diagnose the source of flakiness for that test.

### 5. Fix any line in TestExpectations