1GPU Wrangler Documentation 2=========================== 3 4### Contents ### 5 6* [What does a GPU wrangler do?](#what_is_a_wrangler) 7* [Tracking Wrangler Work do?](#tracking) 8* [View current and upcoming wranglers](#view_current_upcoming_wranglers) 9* [How to swap wrangler shifts](#how_to_swap) 10* [Tips for wranglers](#tips) 11 12 13<a name="what_is_a_wrangler"></a> 14What does a GPU Wrangler do? 15----------------------- 16 17The wrangler has three main jobs: 18 191) Stay on top of incoming GPU-related bugs from clients in various bug trackers. This means triaging and assigning bugs that have a clear owner and investigating and possibly fixing bugs that don't. 20 21 222) Improve the reliability of the GPU bots. This includes dealing with flaky images, crashing bots, etc. We have a never ending set of machine or driver specific issues to deal with. We often brush them under the rug so that we have time for the "real work." When you're wrangler this is "real work." 23 24 253) Improve our tooling. This includes writing new tools and improving existing test tools. Expected results are faster bot run times, more accurate testing, faster testing, surfacing new useful data, and improving debuggability. 26 27 28The wrangler should always prioritize dealing with incoming bugs. The balance of a wrangler's time should be spent divided as seen fit between 2) and 3). It is expected that as much as possible a wrangler puts normal work on pause and focuses on wrangler tasks for the full week. It is ok (and encouraged) to take a deep dive on one particular facet of the wrangler duties and drive it as far as possible during wrangler week (while staying on top of incoming bugs). 29 30Note that the wrangler's job is NOT to spend an abnormal amount of time triaging images, filing bugs for failing bots, or shepherding DEPS rolls. You'll get your chance when you are the general Skia sheriff. 31 32<a name="tracking"></a> 33Tracking Wrangler Work 34----------------------- 35Outside of bug reports, a wrangler should track their progress so that a future wrangler can pick up any batons left shy of the finish line at week's end. This doc is the written history of wrangling: 36https://goto.google.com/skgpu-wrangler-notes 37 38Also, whenever a wrangler figures out how to accomplish a wrangly task (e.g. run a set of Chromium tests that aren't well documented or a cool OpenGL trick used to debug a gnarly issue) the tips section of this doc should be updated to assist future wranglers. 39 40 41<a name="view_current_upcoming_wranglers"></a> 42View current and upcoming wranglers 43---------------------------------- 44 45The list of wranglers is specified in the [skia-tree-status web app](http://skia-tree-status.appspot.com/gpu-sheriff). The current wrangler is highlighted in green. 46The banner on the top of the [status page](https://status.skia.org) also displays the current wrangler. 47 48 49<a name="how_to_swap"></a> 50How to swap wrangler shifts 51-------------------------- 52 53If you need to swap shifts with someone (because you are out sick or on vacation), please get approval from the person you want to swap with. Then send an email to skia-gpu-team@google.com and cc rmistry@. 54 55 56<a name="tips"></a> 57Tips for Wrangers 58----------------- 59 60Please see [this](https://docs.google.com/a/google.com/document/d/1Q1A5T5js4MdqvD0EKjCgNbUBJfRBMPKR3OZAkc-2Tvc/edit?usp=sharing) doc. 61