Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 8fd7bfbe8496c18e6ff09fdc4faac7330da89a61 / . / common / using-dippy-bird / index.html
blob: ab365523b736b341693910e99e2d988e12bb052c [file] [log] [blame]
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]1
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]2<!doctype html>
3<html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]8
9
10
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]11 <link rel="shortcut icon" href="../../assets/images/favicon.png">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]12 <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.0.1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]13
14
15
16 <title>Using `dippy-bird` - Team Bliss</title>
17
18
19
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]20 <link rel="stylesheet" href="../../assets/stylesheets/main.38780c08.min.css">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]21
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]22
23 <link rel="stylesheet" href="../../assets/stylesheets/palette.3f72e892.min.css">
24
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]25
26
27
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]28
29
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]30
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]31 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]32 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
33 <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]34
35
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]36
37
38
39
40
41
42 </head>
43
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]44
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]45
46
47
48
49
50 <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none">
51
52
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]53 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
54 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]55 <label class="md-overlay" for="__drawer"></label>
56 <div data-md-component="skip">
57
58
59 <a href="#using-dippy-bird" class="md-skip">
60 Skip to content
61 </a>
62
63 </div>
64 <div data-md-component="announce">
65
66 </div>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]67
68 <header class="md-header" data-md-component="header">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]69 <nav class="md-header-nav md-grid" aria-label="Header">
70 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo" aria-label="Team Bliss">
71
72
73 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
74
75 </a>
76 <label class="md-header-nav__button md-icon" for="__drawer">
77 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
78 </label>
79 <div class="md-header-nav__title" data-md-component="header-title">
80
81 <div class="md-header-nav__ellipsis">
82 <span class="md-header-nav__topic md-ellipsis">
83 Team Bliss
84 </span>
85 <span class="md-header-nav__topic md-ellipsis">
86
87 Using `dippy-bird`
88
89 </span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]90 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]91
92 </div>
93
94 <label class="md-header-nav__button md-icon" for="__search">
95 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
96 </label>
97
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]98<div class="md-search" data-md-component="search" role="dialog">
99 <label class="md-search__overlay" for="__search"></label>
100 <div class="md-search__inner" role="search">
101 <form class="md-search__form" name="search">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]102 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active">
103 <label class="md-search__icon md-icon" for="__search">
104 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
105 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
106 </label>
107 <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1">
108 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]109 </button>
110 </form>
111 <div class="md-search__output">
112 <div class="md-search__scrollwrap" data-md-scrollfix>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]113 <div class="md-search-result" data-md-component="search-result">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]114 <div class="md-search-result__meta">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]115 Initializing search
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]116 </div>
117 <ol class="md-search-result__list"></ol>
118 </div>
119 </div>
120 </div>
121 </div>
122</div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]123
124
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]125 </nav>
126</header>
127
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]128 <div class="md-container" data-md-component="container">
129
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]130
131
132
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]133 <main class="md-main" data-md-component="main">
134 <div class="md-main__inner md-grid">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]135
136
137 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
138 <div class="md-sidebar__scrollwrap">
139 <div class="md-sidebar__inner">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]140 <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
141 <label class="md-nav__title" for="__drawer">
142 <a href="../.." title="Team Bliss" class="md-nav__button md-logo" aria-label="Team Bliss">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]143
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]144
145 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
146
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]147 </a>
148 Team Bliss
149 </label>
150
151 <ul class="md-nav__list" data-md-scrollfix>
152
153
154
155
156
157
158 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]159 <a href="../.." title="Home" class="md-nav__link">
160 Home
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]161 </a>
162 </li>
163
164
165
166
167
168
169
170 <li class="md-nav__item md-nav__item--nested">
171
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]172 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]173
174 <label class="md-nav__link" for="nav-2">
175 Bliss OS
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]176 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]177 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]178 <nav class="md-nav" aria-label="Bliss OS" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]179 <label class="md-nav__title" for="nav-2">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]180 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]181 Bliss OS
182 </label>
183 <ul class="md-nav__list" data-md-scrollfix>
184
185
186
187
188
189
190
191 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]192 <a href="../../Bliss%20OS/" title="Index" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]193 Index
194 </a>
195 </li>
196
197
198
199
200
201
202
203 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]204 <a href="../../Bliss%20OS/build-guide/" title="Build Guide" class="md-nav__link">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]205 Build Guide
206 </a>
207 </li>
208
209
210
211
212
213
214
215 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]216 <a href="../../Bliss%20OS/extras/" title="Extras" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]217 Extras
218 </a>
219 </li>
220
221
222
223
224
225
226
227 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]228 <a href="../../Bliss%20OS/installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]229 Installation Guide (Misc)
230 </a>
231 </li>
232
233
234
235
236
237
238
239 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]240 <a href="../../Bliss%20OS/installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]241 Installation Guide (Surface devices)
242 </a>
243 </li>
244
245
246
247
248
249
250
251 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]252 <a href="../../Bliss%20OS/installation-guide/" title="Installation Guide" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]253 Installation Guide
254 </a>
255 </li>
256
257
258
259
260
261
262
263 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]264 <a href="../../Bliss%20OS/taking-bug-reports/" title="Taking bug reports" class="md-nav__link">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]265 Taking bug reports
266 </a>
267 </li>
268
269
270
271
272
273
274
275 <li class="md-nav__item">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]276 <a href="../../Bliss%20OS/troubleshooting/" title="Troubleshooting" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]277 Troubleshooting
278 </a>
279 </li>
280
281
282 </ul>
283 </nav>
284 </li>
285
286
287
288
289
290
291
292 <li class="md-nav__item md-nav__item--nested">
293
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]294 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]295
296 <label class="md-nav__link" for="nav-3">
297 BlissRoms
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]298 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]299 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]300 <nav class="md-nav" aria-label="BlissRoms" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]301 <label class="md-nav__title" for="nav-3">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]302 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]303 BlissRoms
304 </label>
305 <ul class="md-nav__list" data-md-scrollfix>
306
307
308
309
310
311
312
313 <li class="md-nav__item">
314 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
315 Index
316 </a>
317 </li>
318
319
320
321
322
323
324
325 <li class="md-nav__item">
326 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
327 Build Guide
328 </a>
329 </li>
330
331
332
333
334
335
336
337 <li class="md-nav__item">
338 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
339 Build Tips
340 </a>
341 </li>
342
343
344 </ul>
345 </nav>
346 </li>
347
348
349
350
351
352
353
354
355
356 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
357
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]358 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4" checked>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]359
360 <label class="md-nav__link" for="nav-4">
361 Common
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]362 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]363 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]364 <nav class="md-nav" aria-label="Common" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]365 <label class="md-nav__title" for="nav-4">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]366 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]367 Common
368 </label>
369 <ul class="md-nav__list" data-md-scrollfix>
370
371
372
373
374
375
376
377 <li class="md-nav__item">
378 <a href="../" title="Index" class="md-nav__link">
379 Index
380 </a>
381 </li>
382
383
384
385
386
387
388
389 <li class="md-nav__item">
390 <a href="../git-started/" title="Git Started" class="md-nav__link">
391 Git Started
392 </a>
393 </li>
394
395
396
397
398
399
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame]400
401 <li class="md-nav__item">
402 <a href="../maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
403 Maintaining proper authorship
404 </a>
405 </li>
406
407
408
409
410
411
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]412
413
414
415 <li class="md-nav__item md-nav__item--active">
416
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]417 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]418
419
420
421
422 <label class="md-nav__link md-nav__link--active" for="__toc">
423 Using `dippy-bird`
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]424 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]425 </label>
426
427 <a href="./" title="Using `dippy-bird`" class="md-nav__link md-nav__link--active">
428 Using `dippy-bird`
429 </a>
430
431
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]432<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]433
434
435
436
437
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]438 <label class="md-nav__title" for="__toc">
439 <span class="md-nav__icon md-icon"></span>
440 Table of contents
441 </label>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]442 <ul class="md-nav__list" data-md-scrollfix>
443
444 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]445 <a href="#installation" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]446 Installation
447 </a>
448
449</li>
450
451 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]452 <a href="#usage" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]453 Usage
454 </a>
455
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]456 <nav class="md-nav" aria-label="Usage">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]457 <ul class="md-nav__list">
458
459 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]460 <a href="#reviewing-commits-code-review-only" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]461 Reviewing commits (code-review only)
462 </a>
463
464</li>
465
466 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]467 <a href="#reviewing-commits-code-review-and-verification" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]468 Reviewing commits (code-review and verification)
469 </a>
470
471</li>
472
Eric Park847635a2019-10-21 14:42:24 +0800[diff] [blame]473 <li class="md-nav__item">
474 <a href="#submitting-commits-admins-only" class="md-nav__link">
475 Submitting commits (admins only)
476 </a>
477
478</li>
479
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]480 </ul>
481 </nav>
482
483</li>
484
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]485 </ul>
486
487</nav>
488
489 </li>
490
491
492 </ul>
493 </nav>
494 </li>
495
496
497
498
499
500
501
502 <li class="md-nav__item md-nav__item--nested">
503
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]504 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]505
506 <label class="md-nav__link" for="nav-5">
507 Infrastructure
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]508 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]509 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]510 <nav class="md-nav" aria-label="Infrastructure" data-md-level="1">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]511 <label class="md-nav__title" for="nav-5">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]512 <span class="md-nav__icon md-icon"></span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]513 Infrastructure
514 </label>
515 <ul class="md-nav__list" data-md-scrollfix>
516
517
518
519
520
521
522
523 <li class="md-nav__item">
524 <a href="../../infrastructure/" title="Index" class="md-nav__link">
525 Index
526 </a>
527 </li>
528
529
530 </ul>
531 </nav>
532 </li>
533
534
535 </ul>
536</nav>
537 </div>
538 </div>
539 </div>
540
541
542 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
543 <div class="md-sidebar__scrollwrap">
544 <div class="md-sidebar__inner">
545
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]546<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]547
548
549
550
551
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]552 <label class="md-nav__title" for="__toc">
553 <span class="md-nav__icon md-icon"></span>
554 Table of contents
555 </label>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]556 <ul class="md-nav__list" data-md-scrollfix>
557
558 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]559 <a href="#installation" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]560 Installation
561 </a>
562
563</li>
564
565 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]566 <a href="#usage" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]567 Usage
568 </a>
569
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]570 <nav class="md-nav" aria-label="Usage">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]571 <ul class="md-nav__list">
572
573 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]574 <a href="#reviewing-commits-code-review-only" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]575 Reviewing commits (code-review only)
576 </a>
577
578</li>
579
580 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]581 <a href="#reviewing-commits-code-review-and-verification" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]582 Reviewing commits (code-review and verification)
583 </a>
584
585</li>
586
Eric Park847635a2019-10-21 14:42:24 +0800[diff] [blame]587 <li class="md-nav__item">
588 <a href="#submitting-commits-admins-only" class="md-nav__link">
589 Submitting commits (admins only)
590 </a>
591
592</li>
593
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]594 </ul>
595 </nav>
596
597</li>
598
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]599 </ul>
600
601</nav>
602 </div>
603 </div>
604 </div>
605
606
607 <div class="md-content">
608 <article class="md-content__inner md-typeset">
609
610
611
612 <h1 id="using-dippy-bird">Using <code>dippy-bird</code></h1>
613<p>If you want to review commits quickly on our Gerrit, <a href="https://github.com/wikimedia/mediawiki-tools-dippybird/blob/master/dippy-bird.php">use the <code>dippy-bird.php</code> script created by the WikiMedia foundation.</a></p>
614<p>Thanks to Vaughn Newman (@rwaterspf1) for the original instructions!</p>
615<h2 id="installation">Installation</h2>
616<p>Make sure you have PHP installed.</p>
617<p><a href="https://github.com/wikimedia/mediawiki-tools-dippybird/blob/master/dippy-bird.php">Download the script</a> and put it in an easily-accessible place.</p>
618<h2 id="usage">Usage</h2>
619<h3 id="reviewing-commits-code-review-only">Reviewing commits (code-review only)</h3>
620<p>To review commits, run:</p>
621<pre><code>php dippy-bird.php --username=ideaman924 --server=review.blissroms.com --port=29418 -q="status:open topic:test" -a=review --review=+1 --verify=0
622</code></pre>
623<p>This will review all commits that match the following criteria:</p>
624<ul>
625<li>Is open for review (not closed, merged, or abandoned)</li>
626<li>Has the topic <code>test</code></li>
627</ul>
628<p>And will apply +1 code-review and no verify, indicating that you have a successful build with the commits included.</p>
629<h3 id="reviewing-commits-code-review-and-verification">Reviewing commits (code-review and verification)</h3>
630<p>To review commits with verification, run:</p>
631<pre><code>php dippy-bird.php --username=ideaman924 --server=review.blissroms.com --port=29418 -q="status:open topic:test" -a=review --review=+2 --verify=+1
632</code></pre>
633<p>This will review all commits that match the following criteria:</p>
634<ul>
635<li>Is open for review (not closed, merged, or abandoned)</li>
636<li>Has the topic <code>test</code></li>
637</ul>
638<p>And will apply +2 code-review and +1 verify, indicating that you have tested the commits on an actual device. This means that the commits are now ready for merging.</p>
Eric Park847635a2019-10-21 14:42:24 +0800[diff] [blame]639<h3 id="submitting-commits-admins-only">Submitting commits (admins only)</h3>
640<p>To submit commits that are already reviewed, run:</p>
641<pre><code>php dippy-bird.php --username=jackeagle --server=review.blissroms.com --port=29418 -q="status:open topic:test" -a=submit
642</code></pre>
643<p>This will submit all commits that match the following criteria:</p>
644<ul>
645<li>Is open for review (not closed, merged, or abandoned)</li>
646<li>Has the topic <code>test</code></li>
647</ul>
648<p>And will push them to our main GitHub. If the commits are not reviewed yet, or if they do not have the verified tag, this command will fail for the patchsets that are not reviewed yet. Other commits will still be merged.</p>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]649
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]650
651
652
653
654
655
656 </article>
657 </div>
658 </div>
659 </main>
660
661
662<footer class="md-footer">
663
664 <div class="md-footer-nav">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]665 <nav class="md-footer-nav__inner md-grid" aria-label="Footer">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]666
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]667 <a href="../maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev">
668 <div class="md-footer-nav__button md-icon">
669 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]670 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]671 <div class="md-footer-nav__title">
672 <div class="md-ellipsis">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]673 <span class="md-footer-nav__direction">
674 Previous
675 </span>
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame]676 Maintaining proper authorship
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]677 </div>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]678 </div>
679 </a>
680
681
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]682 <a href="../../infrastructure/" title="Index" class="md-footer-nav__link md-footer-nav__link--next" rel="next">
683 <div class="md-footer-nav__title">
684 <div class="md-ellipsis">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]685 <span class="md-footer-nav__direction">
686 Next
687 </span>
688 Index
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]689 </div>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]690 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]691 <div class="md-footer-nav__button md-icon">
692 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]693 </div>
694 </a>
695
696 </nav>
697 </div>
698
699 <div class="md-footer-meta md-typeset">
700 <div class="md-footer-meta__inner md-grid">
701 <div class="md-footer-copyright">
702
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]703 Made with
704 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
705 Material for MkDocs
706 </a>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]707 </div>
708
709 </div>
710 </div>
711</footer>
712
713 </div>
714
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]715 <script src="../../assets/javascripts/vendor.77e55a48.min.js"></script>
716 <script src="../../assets/javascripts/bundle.aa3f9871.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]717
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]718 <script>
719 app = initialize({
720 base: "../..",
721 features: [],
722 search: Object.assign({
723 worker: "../../assets/javascripts/worker/search.4ac00218.min.js"
724 }, typeof search !== "undefined" && search)
725 })
726 </script>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]727
728
729 </body>
730</html>