doc: recommend benchstat for performance commits

The benchstat tool computes statistics about benchmarks, including
whether any differences are statistically significant. Recommend its use
in commit messages of performance-related changes rather than the
simpler benchcmp tool.

Change-Id: I4b35c2d892b48e60c3064489b035774792c19c30
Reviewed-on: https://go-review.googlesource.com/132515
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
This commit is contained in:
Rhys Hiltner 2018-08-30 20:09:08 -07:00 committed by Brad Fitzpatrick
parent 7c96f9b527
commit 677c4acc98
1 changed files with 1 additions and 1 deletions

View File

@ -696,7 +696,7 @@ Don't use HTML, Markdown, or any other markup language.
<p> <p>
Add any relevant information, such as benchmark data if the change Add any relevant information, such as benchmark data if the change
affects performance. affects performance.
The <a href="https://godoc.org/golang.org/x/tools/cmd/benchcmp">benchcmp</a> The <a href="https://godoc.org/golang.org/x/perf/cmd/benchstat">benchstat</a>
tool is conventionally used to format tool is conventionally used to format
benchmark data for change descriptions. benchmark data for change descriptions.
</p> </p>