@@ -19,8 +19,14 @@ up on any promised actions. (I.e. nag people!)
19
19
Start a new triage log entry. Follow the format of the preceding entries.
20
20
21
21
Look through the [ ` instructions:u ` graphs] ( https://perf.rust-lang.org ) for each
22
- benchmark, looking for significant changes (regressions or improvements) in the
23
- period since the last triage.
22
+ benchmark.
23
+ - Record the hash of the latest measured revision in the log entry.
24
+ - Set the "start" revision to the previous log entry's latest revision, and the
25
+ "end" revision to the latest revision. Full SHAs must be used.
26
+ - Uncheck the "Absolute data" checkbox, because that makes changes easier to
27
+ see.
28
+
29
+ Look for significant changes (regressions or improvements) in the graphs.
24
30
- Click and drag a region of a graph to zoom in on it. This is useful when data
25
31
points are close together.
26
32
- Click on a data point to open the "compare" page for that merge.
@@ -34,8 +40,10 @@ Easy cases: there is only a single PR in the merge.
34
40
regression, consider requesting a backout. It may be worth looking through
35
41
the comments to see if any perf CI runs were done, and whether the
36
42
regression was expected.
37
- - Add an entry to the triage log. Include useful details, especially promises
38
- of follow-up action from authors.
43
+ - Add an entry to the triage log. Include the PR title, a link to it, and a
44
+ link to the performance results. Include useful details, such as the size of
45
+ the regression/improvement, and any promises of follow-up action from authors
46
+ in the case of a regression.
39
47
40
48
Difficult cases: the merge was a rollup of multiple PRs.
41
49
- Look through the PRs and try to determine which was the cause. Often you
@@ -47,6 +55,7 @@ Difficult cases: the merge was a rollup of multiple PRs.
47
55
above.
48
56
- You might want to remind the author to use "@bors rollup=never" for PRs
49
57
that are likely to affect performance.
58
+ - Add an entry to the triage log, as for the easy cases.
50
59
51
60
Repeat with the [ ` max-rss `
52
61
graphs] ( https://perf.rust-lang.org/?start=&end=&absolute=true&stat=max-rss ) .
@@ -60,7 +69,7 @@ Rust](https://github.com/emberian/this-week-in-rust/).
60
69
list of notable merged PRs.
61
70
- Within that subsection, add a list containing a single item.
62
71
- That item should be a link to the triage log entry with the form
63
- "YYYY-MM-DD".
72
+ "YYYY-MM-DD", possibly with some brief text about notable things .
64
73
65
74
If you have any questions, the #wg-compiler-performance channel on Discord and
66
75
the t-compiler stream on Zulip are good places to ask.
0 commit comments