commit 824cca56df2b3ba87b8a1432811d3f6762b7efa9
author Sean Liao <sean@liao.dev> Sun Feb 11 13:06:21 2024 +0000
committer Gopher Robot <gobot@golang.org> Wed Feb 21 22:03:32 2024 +0000
tree 173fc532bdb18b71a28aeb0dac6e452b79cd9d26
parent aa63696e928375ac9d5d185fe8c6f76154af1722

_content/doc/install: document minimum bootstrap versions

Fixes golang/go#65654
Updates golang/go#54265
Updates golang/go#44505

Change-Id: Ia1c9b50a2f66b67db43e8dcd21b1002b66cf30fa
Reviewed-on: https://go-review.googlesource.com/c/website/+/562619
Auto-Submit: Robert Findley <rfindley@google.com>
Reviewed-by: Robert Findley <rfindley@google.com>
Reviewed-by: Austin Clements <austin@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>

_content/doc/install/source.html

diff --git a/_content/doc/install/source.html b/_content/doc/install/source.html
index 54ff166..f5630e9 100644
--- a/_content/doc/install/source.html
+++ b/_content/doc/install/source.html
@@ -130,6 +130,19 @@
 <code>$GOROOT_BOOTSTRAP/bin/go</code> should be the go command to use.</p>
 
 <p>
+The minimum version of Go required depends on the target version of Go:
+</p>
+
+<ul>
+<li> Go &lt;= 1.4: a C toolchain.
+<li> 1.5 &lt;= Go &lt;= 1.19: a Go 1.4 compiler.
+<li> 1.20 &lt;= Go &lt;= 1.21: a Go 1.17 compiler.
+<li> 1.22 &lt;= Go &lt;= 1.23: a Go 1.20 compiler.
+<li> Going forward, Go version 1.N will require a Go 1.M compiler, 
+where M is N-2 rounded down to an even number. Example: Go 1.24 and 1.25 require Go 1.22.
+</ul>
+
+<p>
 There are four possible ways to obtain a bootstrap toolchain:
 </p>
 
@@ -149,7 +162,7 @@
 <p>
 To use a binary release as a bootstrap toolchain, see
 <a href="/dl/">the downloads page</a> or use any other
-packaged Go distribution.
+packaged Go distribution meeting the minimum version requirements.
 </p>
 
 <h3 id="bootstrapFromCrosscompiledSource">Bootstrap toolchain from cross-compiled source</h3>