doc: add a release note for greenteagc GOEXPERIMENT

For #71661.

Change-Id: I802b0c36cac3bbd87b35ff216f06822e87fb7b5d
Reviewed-on: https://go-review.googlesource.com/c/go/+/671439
Reviewed-by: Michael Pratt <mpratt@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>

diff --git a/doc/next/4-runtime.md b/doc/next/4-runtime.md
index e19996863df4cd1d25f1586182e51c4ef7ab7a7a..4e8182c8cf8939d91b67a807ee72a3ca091715cd 100644 (file)
--- a/doc/next/4-runtime.md
+++ b/doc/next/4-runtime.md
@@ -24,3 +24,15 @@ On Linux systems with kernel support for anonymous VMA names
 mappings with context about their purpose. e.g., `[anon: Go: heap]` for heap
 memory. This can be disabled with the [GODEBUG setting](/doc/godebug)
 `decoratemappings=0`.
+
+<!-- go.dev/issue/73581 -->
+
+A new experimental garbage collector is now available as an experiment. The
+new design aims to improve the efficiency of garbage collection through better
+locality and CPU scalability in the mark algorithm. Benchmark result vary, but
+we expect somewhere between a 10—40% reduction in garbage collection overhead
+in real-world programs that heavily use the garbage collector.
+
+The new garbage collector may be enabled by setting `GOEXPERIMENT=greenteagc`
+at build time. See the [GitHub issue](/issue/73581) for more details on the design
+and instructions on how to report feedback.