From: Russ Cox <rsc@golang.org>
Date: Mon, 5 Jun 2023 16:42:58 +0000 (-0400)
Subject: doc/go1.21: move Ports to end
X-Git-Tag: go1.21rc1~100
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=eb413f7bcd27569494c6296c8f2bb3d8f2d8710d;p=gostls13.git

doc/go1.21: move Ports to end

The most important parts of almost any release notes are the
language and tool changes. Those should be the first two sections.
Instead Ports interrupts the flow with information that usually
matters only to very few users.

Move Ports to the end of the release notes.

Change-Id: I78492e91e368184fb5f8e8d44d63f35b8f14eeae
Reviewed-on: https://go-review.googlesource.com/c/go/+/500957
TryBot-Bypass: Russ Cox <rsc@golang.org>
Reviewed-by: Ian Lance Taylor <iant@google.com>
---

diff --git a/doc/go1.21.html b/doc/go1.21.html
index 47edb6d402..575f93b9b5 100644
--- a/doc/go1.21.html
+++ b/doc/go1.21.html
@@ -137,62 +137,6 @@ Do not send CLs removing the interior tags from such phrases.
   TODO: complete this section
 </p>
 
-<h2 id="ports">Ports</h2>
-
-<h3 id="darwin">Darwin</h3>
-
-<p><!-- go.dev/issue/57125 -->
-  As <a href="go1.20#darwin">announced</a> in the Go 1.20 release notes,
-  Go 1.21 requires macOS 10.15 Catalina or later;
-  support for previous versions has been discontinued.
-</p>
-
-<h3 id="windows">Windows</h3>
-
-<p><!-- go.dev/issue/57003, go.dev/issue/57004 -->
-  As <a href="go1.20#windows">announced</a> in the Go 1.20 release notes,
-  Go 1.21 requires at least Windows 10 or Windows Server 2016;
-  support for previous versions has been discontinued.
-</p>
-
-<!-- CL 470695 -->
-<p>
-  <!-- cmd/dist: default to GOARM=7 on all non-arm systems -->
-</p>
-
-<h3 id="wasm">WebAssembly</h3>
-
-<p><!-- https://go.dev/issue/38248, https://go.dev/issue/59149, CL 489255 -->
-  The new <code>go:wasmimport</code> directive can now be used in Go programs
-  to import functions from the WebAssembly host.
-</p>
-
-<!-- https://go.dev/issue/56100 -->
-<p>
-  The Go scheduler now interacts much more efficiently with the
-  JavaScript event loop, especially in applications that block
-  frequently on asynchronous events.
-</p>
-
-
-<h3 id="wasip1">WebAssembly System Interface</h3>
-
-<p><!-- https://go.dev/issue/58141 -->
-  Go 1.21 adds an experimental port to the <a href="https://wasi.dev/">
-  WebAssembly System Interface (WASI)</a>, Preview 1
-  (<code>GOOS=wasip1</code>, <code>GOARCH=wasm</code>).
-</p>
-
-<p>
-  As a result of the addition of the new <code>GOOS</code> value
-  "<code>wasip1</code>", Go files named <code>*_wasip1.go</code>
-  will now be <a href="/pkg/go/build/#hdr-Build_Constraints">ignored
-  by Go tools</a> except when that <code>GOOS</code> value is being
-  used.
-  If you have existing filenames matching that pattern, you will
-  need to rename them.
-</p>
-
 <h2 id="tools">Tools</h2>
 
 <!-- https://go.dev/issue/15513 -->
@@ -1009,6 +953,63 @@ Do not send CLs removing the interior tags from such phrases.
     </p>
 </dl><!-- unicode -->
 
+<h2 id="ports">Ports</h2>
+
+<h3 id="darwin">Darwin</h3>
+
+<p><!-- go.dev/issue/57125 -->
+  As <a href="go1.20#darwin">announced</a> in the Go 1.20 release notes,
+  Go 1.21 requires macOS 10.15 Catalina or later;
+  support for previous versions has been discontinued.
+</p>
+
+<h3 id="windows">Windows</h3>
+
+<p><!-- go.dev/issue/57003, go.dev/issue/57004 -->
+  As <a href="go1.20#windows">announced</a> in the Go 1.20 release notes,
+  Go 1.21 requires at least Windows 10 or Windows Server 2016;
+  support for previous versions has been discontinued.
+</p>
+
+<!-- CL 470695 -->
+<p>
+  <!-- cmd/dist: default to GOARM=7 on all non-arm systems -->
+</p>
+
+<h3 id="wasm">WebAssembly</h3>
+
+<p><!-- https://go.dev/issue/38248, https://go.dev/issue/59149, CL 489255 -->
+  The new <code>go:wasmimport</code> directive can now be used in Go programs
+  to import functions from the WebAssembly host.
+</p>
+
+<!-- https://go.dev/issue/56100 -->
+<p>
+  The Go scheduler now interacts much more efficiently with the
+  JavaScript event loop, especially in applications that block
+  frequently on asynchronous events.
+</p>
+
+
+<h3 id="wasip1">WebAssembly System Interface</h3>
+
+<p><!-- https://go.dev/issue/58141 -->
+  Go 1.21 adds an experimental port to the <a href="https://wasi.dev/">
+  WebAssembly System Interface (WASI)</a>, Preview 1
+  (<code>GOOS=wasip1</code>, <code>GOARCH=wasm</code>).
+</p>
+
+<p>
+  As a result of the addition of the new <code>GOOS</code> value
+  "<code>wasip1</code>", Go files named <code>*_wasip1.go</code>
+  will now be <a href="/pkg/go/build/#hdr-Build_Constraints">ignored
+  by Go tools</a> except when that <code>GOOS</code> value is being
+  used.
+  If you have existing filenames matching that pattern, you will
+  need to rename them.
+</p>
+
+
 <!-- proposals for x repos that don't need to be mentioned here but
      are picked up by the relnote tool. -->
 <!-- https://go.dev/issue/54232 -->