From 9eb14f1b0e748c74f6a7da4cd195db860928cfbc Mon Sep 17 00:00:00 2001
From: Keith Randall <khr@golang.org>
Date: Thu, 17 Feb 2022 09:37:07 -0800
Subject: [PATCH] doc: mention change in append behavior
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

Introduced in CL 347917.

Change-Id: I99b34341f787e779bd45b967110e70a035fa6558
Reviewed-on: https://go-review.googlesource.com/c/go/+/386217
Trust: Keith Randall <khr@golang.org>
Run-TryBot: Keith Randall <khr@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Martin Möhrmann <martin@golang.org>
Trust: Martin Möhrmann <martin@golang.org>
Run-TryBot: Martin Möhrmann <martin@golang.org>
---
 doc/go1.18.html | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/go1.18.html b/doc/go1.18.html
index b320579c37..1ca0a5560d 100644
--- a/doc/go1.18.html
+++ b/doc/go1.18.html
@@ -512,6 +512,12 @@ For more information, see <a href="https://go.dev/design/draft-gobuild">https://
   after each value that may be inaccurate.
 </p>
 
+<p><!-- CL 347917 -->
+  The built-in function <code>append</code> now uses a slightly different formula
+  when deciding how much to grow a slice when it must allocate a new underlying array.
+  The new formula is less prone to sudden transitions in allocation behavior.
+</p>
+
 <h2 id="compiler">Compiler</h2>
 
 <p><!-- https://golang.org/issue/40724 -->
-- 
2.48.1