From 82c6967adad6319ac08fca4f3e84066a43083963 Mon Sep 17 00:00:00 2001
From: Michael Matloob <matloob@golang.org>
Date: Fri, 4 Nov 2022 16:29:15 -0400
Subject: [PATCH] doc: add a release note for fewer pre-compiled GOROOT .a
 files

For #47257

Change-Id: I3837220d02741da92d723484c82d11e82c92151a
Reviewed-on: https://go-review.googlesource.com/c/go/+/448017
TryBot-Result: Gopher Robot <gobot@golang.org>
Run-TryBot: Michael Matloob <matloob@golang.org>
Reviewed-by: Benny Siegert <bsiegert@gmail.com>
Reviewed-by: Bryan Mills <bcmills@google.com>
---
 doc/go1.20.html | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/go1.20.html b/doc/go1.20.html
index c3f5e8a3ec..4b726b5a77 100644
--- a/doc/go1.20.html
+++ b/doc/go1.20.html
@@ -47,6 +47,18 @@ Do not send CLs removing the interior tags from such phrases.
   TODO: <a href="https://go.dev/issue/45454">https://go.dev/issue/45454</a>: provide build tags for architecture environment variables
 </p>
 
+<p>
+  The Go distribution no longer ships with pre-compiled <code>.a</code>
+  files for most of the packages in <code>GOROOT</code>, now only including
+  .a files for the five packages in <code>GOROOT</code> that use <code>cgo</code>.
+  Instead, those packages will be built as needed and cached in the build
+  cache, as is already done for non-<code>main</code> packages outside
+  <code>GOROOT</code>. Further, <code>go</code> <code>install</code> will
+  also not install <code>.a</code> files for <code>GOROOT</code> packages
+  except for those that use <code>cgo</code>. These changes are intended to
+  reduce the size of the Go distribution, in some cases by up to two-thirds.
+</p>
+
 <p><!-- https://go.dev/issue/37015 -->
   When the main module is located within <code>GOPATH/src</code>,
   <code>go</code> <code>install</code> no longer installs libraries for
-- 
2.52.0