| OLD | NEW |
| 1 You want to be very careful about updating the reference builds, because it | 1 You want to be very careful about updating the reference builds, because it |
| 2 means changing the baseline all new builds are compared to on the performance | 2 means changing the baseline all new builds are compared to on the performance |
| 3 graphs and can easily let regressions slip in. Ensure that the new builds that | 3 graphs and can easily let regressions slip in. Ensure that the new builds that |
| 4 you use don't have any performance regressions by looking at the perf dashboard. | 4 you use don't have any performance regressions by looking at the perf dashboard. |
| 5 | 5 |
| 6 | 6 |
| 7 IMPORTANT: When you update the reference builds, please send email to | 7 IMPORTANT: When you update the reference builds, please send email to |
| 8 chrome-perf-sheriffs@google.com announcing the change, so that | 8 chrome-perf-sheriffs@google.com announcing the change, so that |
| 9 build.chromium.org's performance expectations will be reset. | 9 build.chromium.org's performance expectations will be reset. |
| 10 | 10 |
| 11 | 11 |
| 12 To update the reference builds: | 12 To update the reference builds: |
| 13 | 13 |
| 14 1. Select a target revision number that is green on all platforms. | 14 1. Select a target revision number that is green on all platforms. |
| 15 | 15 |
| 16 2. Run src/tools/update_reference_build.py from a tmp directory. For example: | 16 2. Run src/tools/update_reference_build.py from a tmp directory. To update a |
| 17 Chromium reference build use -r <revision> option, for Chrome official |
| 18 builds use -b <build_number>. To update a specific platform use |
| 19 -p <platform> option. For example: |
| 17 | 20 |
| 18 $ cd /tmp | 21 $ cd /tmp |
| 22 # Update a Chromium revision, example -r 123456 |
| 19 $ /path/to/tools/update_reference_build.py -r <revision> | 23 $ /path/to/tools/update_reference_build.py -r <revision> |
| 20 | 24 |
| 25 # Update a Chrome build, example -p Linux -b 30.0.1599.33 |
| 26 $ /path/to/tools/update_reference_build.py -p <platform> -b <build_number> |
| 27 |
| 28 |
| 21 3. Move to reference_builds/reference_builds and prepare a changelist. | 29 3. Move to reference_builds/reference_builds and prepare a changelist. |
| 22 For example: | 30 For example: |
| 23 | 31 |
| 24 $ cd reference_builds/reference_builds | 32 $ cd reference_builds/reference_builds |
| 25 $ gcl change | 33 $ gcl change |
| 26 $ gcl upload <change> | 34 $ gcl upload <change> |
| 27 $ gcl commit <change> | 35 $ gcl commit <change> |
| 28 | 36 |
| 29 4. After your change is committed, roll the reference_build dependencies for | 37 4. After your change is committed, roll the reference_build dependencies for |
| 30 each platform in src/DEPS. | 38 each platform in src/DEPS. |
| OLD | NEW |