-
Notifications
You must be signed in to change notification settings - Fork 17.7k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
doc: write release notes for Go 1.23 #65614
Comments
Change https://go.dev/cl/563856 mentions this issue: |
For #64207. For #65614. Change-Id: Ia5365b4090060e0657c255341751d3e67691f836 Reviewed-on: https://go-review.googlesource.com/c/go/+/563856 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Than McIntosh <thanm@google.com>
For golang#64207. For golang#65614. Change-Id: Ia5365b4090060e0657c255341751d3e67691f836 Reviewed-on: https://go-review.googlesource.com/c/go/+/563856 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Than McIntosh <thanm@google.com>
For golang#64707 For golang#65614 Signed-off-by: aimuz <mr.imuz@gmail.com>
Change https://go.dev/cl/568755 mentions this issue: |
For #64707. For #65614. Change-Id: Ib07ac67d7652bc7c9e1363f70637938c7bb4bc72 GitHub-Last-Rev: a4d8eca GitHub-Pull-Request: #66089 Reviewed-on: https://go-review.googlesource.com/c/go/+/568755 Reviewed-by: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com> Reviewed-by: Michael Knyszek <mknyszek@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
I think 3c78ace's changes are worth mentioning. |
@jfrech Thanks, but the release notes are for changes that users need to know because they are new or because they will affect the way that programs work. We don't usually mention specific optimizations in the release notes, unless they affect the great majority of Go programs. |
Change https://go.dev/cl/587415 mentions this issue: |
Change https://go.dev/cl/587436 mentions this issue: |
Go release notes always start out as a draft with a clear notice. That notice is removed when the final release (go1.N.0) is made. For example, the last time was in CL 562255. Add this to the Go 1.23 draft and to the future fragment template. Also switch to the main pkg.go.dev instance and use a relative issue link in 3-tools.md while here. For #64169. For #65614. Change-Id: I16bc0fa8a3a43ee7a9edd7fa253999041f1892e2 Reviewed-on: https://go-review.googlesource.com/c/go/+/587415 Reviewed-by: Jonathan Amsterdam <jba@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> TryBot-Bypass: Dmitri Shuralyov <dmitshur@golang.org> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
The improved release note process is being used starting with Go 1.23. That means instead of a single doc/go1.23.html draft file in the main Go repository, doc/next contains a set of release note fragments. Having small, orthogonal files avoids merge conflicts, and a release note test requires that release notes are written and included in the same CL that's adding new APIs. As a result, the set of completed release notes even before we enter the release freeze is greater than ever before. While it's possible to view those fragments using tip.golang.org (e.g., by visiting https://tip.golang.org/doc/next), reading them that way isn't practical. The relnote generate tool exists to merge fragments into a complete Markdown document, and this tool will be used when eventually moving a complete draft of Go 1.23 release notes to x/website. To aid the remaining work of completing the release note draft, this change adds a dynamic /doc/next page to preview what the relnote generate tool will produce. Combined with existing functionality of the -tip flag, it makes https://tip.golang.org/doc/next display a live preview of the checked-in release notes draft. It can also be used to preview release note draft locally. For example, if $HOME/gotip is a Go checkout where one is editing doc/next content: go run golang.org/x/website/cmd/golangorg@latest -goroot=$HOME/gotip Will serve a live preview at http://localhost:6060/go.dev/doc/next. It can be slightly more convenient to refresh a browser without having to re-run 'relnote generate'. For golang/go#64169. For golang/go#65614. Change-Id: Ie1d3650076421a95a691dd84a554a113dd1187b1 Reviewed-on: https://go-review.googlesource.com/c/website/+/587436 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Jonathan Amsterdam <jba@google.com>
Change https://go.dev/cl/587695 mentions this issue: |
Add a release note for the flag that CL 585401 added. For #27005. For #65614. Change-Id: Ib26eb1b85c511d3cb41a29a8d9354577dd9a0e14 Reviewed-on: https://go-review.googlesource.com/c/go/+/587695 Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Sam Thanawalla <samthanawalla@google.com>
Change https://go.dev/cl/588015 mentions this issue: |
This is the first round of TODOs created based on relnote todo output. There are many entries that need to be documented, expanded, reworded, and this change makes progress on setting that up. For this cycle, relnote todo implemented a simple heuristic of finding CLs that mention accepted proposals (see issue 62376, or comment https://go.dev/issue/62376#issuecomment-2101086794 specifically). The "Items that don't need to be mentioned in Go 1.23 release notes but are picked up by relnote todo." section in todo.md contains an attempt at reviewing that list. The large number of items needed to be reviewed made it impractical to spend much time on any individual one. For #65614. Change-Id: Id9d5f1795575a46df2ec4ed0088de07ee6075a90 Reviewed-on: https://go-review.googlesource.com/c/go/+/588015 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Carlos Amedee <carlos@golang.org>
Change https://go.dev/cl/588057 mentions this issue: |
Add this file now so we can use the https://tip.golang.org/doc/go1.23 both before and after the release note fragments are merged, meaning we won't need to tell people to abruptly stop looking at /doc/next and start looking at /doc/go1.23 sometime in the next few weeks. The /doc/next page may still be useful in some contexts where a moving target URL works better than a fixed one, so leave it behind for now. For golang/go#65614. Change-Id: Ib28608f56b2a88b44e554bf24c04873f3ed6961b Reviewed-on: https://go-review.googlesource.com/c/website/+/588057 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Jonathan Amsterdam <jba@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Change https://go.dev/cl/587927 mentions this issue: |
For #65614. Change-Id: I759bf671b8f84c5224798b0dfaee6b158fdcc95a Reviewed-on: https://go-review.googlesource.com/c/go/+/587927 Reviewed-by: Carlos Amedee <carlos@golang.org> Auto-Submit: Michael Knyszek <mknyszek@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Change https://go.dev/cl/589015 mentions this issue: |
Change https://go.dev/cl/589216 mentions this issue: |
For #65614. Change-Id: I03dc3a46052f1e55dc1ab46b45c886c96c4a1b39 Reviewed-on: https://go-review.googlesource.com/c/go/+/589216 TryBot-Bypass: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Matthew Dempsky <mdempsky@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
This change adds a preannouncement to the release notes. Go 1.24 will require the Linux kernel to be at version 3.17 or later, with an exception that systems running 3.10 or later will continue to be supported if the kernel has been patched to support the getrandom system call. For #65614 For #67001 Change-Id: I61a3838b9ce4f48eb9f94830aa03372d589afdcd Reviewed-on: https://go-review.googlesource.com/c/go/+/589015 LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
For #61308. For #65614. Change-Id: I36b4f2392075d5a3fb9f53a28bd19b997e7be363 Reviewed-on: https://go-review.googlesource.com/c/go/+/592197 Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> TryBot-Bypass: Dmitri Shuralyov <dmitshur@golang.org>
For #67061. For #65614. Change-Id: I0e324b02537e0d40c2092139d31941a1a85a0e69 Reviewed-on: https://go-review.googlesource.com/c/go/+/592196 Reviewed-by: Roland Shoemaker <roland@golang.org> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> TryBot-Bypass: Dmitri Shuralyov <dmitshur@golang.org>
For #65614 Change-Id: I6274bdaba970cfb085af500fdaf8ed078202bfdc Reviewed-on: https://go-review.googlesource.com/c/go/+/591380 Reviewed-by: David Chase <drchase@google.com> Reviewed-by: Russ Cox <rsc@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Change https://go.dev/cl/593495 mentions this issue: |
For #65614 Change-Id: I49921aefb79efbc012e745cc2abd9ff36c0a9149 Reviewed-on: https://go-review.googlesource.com/c/go/+/593495 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Sam Thanawalla <samthanawalla@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Change https://go.dev/cl/594035 mentions this issue: |
Using doc/next content as of 2024-06-21 (commit 1b4f1dc95d221c1e9d0afb9067fd6a09f12dd061). For golang/go#65614. Change-Id: Ifa21855a92dc99f480ea605947cc48d542ff5193 Reviewed-on: https://go-review.googlesource.com/c/website/+/594035 Auto-Submit: Gopher Robot <gobot@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: David Chase <drchase@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Change https://go.dev/cl/594036 mentions this issue: |
The release note fragments have been merged and added as _content/doc/go1.23.md in x/website in CL 594035. For #65614. Change-Id: I7c8c718bc065024b6bdca93ce9bcc3c5d8b2dbc7 Reviewed-on: https://go-review.googlesource.com/c/go/+/594036 LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: David Chase <drchase@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Change https://go.dev/cl/595959 mentions this issue: |
Some packages (iter, maps, structs, and unique) are mentioned in the "Core library" section and there is no content (except comments) in the "Minor changes" section for them. Remove. For golang/go#65614. Change-Id: I9989b83e5cb9893c1d5aa90b36035d797916ae8e Reviewed-on: https://go-review.googlesource.com/c/website/+/595959 LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Than McIntosh <thanm@google.com>
The release note fragments have been merged and added as _content/doc/go1.23.md in x/website in CL 594035. For golang#65614. Change-Id: I7c8c718bc065024b6bdca93ce9bcc3c5d8b2dbc7 Reviewed-on: https://go-review.googlesource.com/c/go/+/594036 LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: David Chase <drchase@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Change https://go.dev/cl/599775 mentions this issue: |
For golang/go#65614. Change-Id: Iecdebfaf4e7467734e60f30867ebcf926e31e97b Reviewed-on: https://go-review.googlesource.com/c/website/+/599775 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Change https://go.dev/cl/600936 mentions this issue: |
For golang/go#68526. For golang/go#65614. Change-Id: I260da94ffaae0d6583e6396b0a78b46dd298313c Reviewed-on: https://go-review.googlesource.com/c/website/+/600936 Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Tim King <taking@google.com> Reviewed-by: Robert Griesemer <gri@google.com> TryBot-Bypass: Robert Griesemer <gri@google.com>
Change https://go.dev/cl/601995 mentions this issue: |
Updates golang/go#65614 Change-Id: I46b53e25a3f81aaecbdef74f02bcafd341530b23 Reviewed-on: https://go-review.googlesource.com/c/website/+/601995 Auto-Submit: Brad Fitzpatrick <bradfitz@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Michael Knyszek <mknyszek@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Change https://go.dev/cl/603717 mentions this issue: |
Briefly describe pidfd, and note the extra opened file descriptors as per request in [1]. [1]: golang/go#62654 (comment) Updates golang/go#62654. For golang/go#65614. Co-authored-by: Michael Pratt <mpratt@google.com> Change-Id: Ie2a8e917cbbb1c6129a1706c22c9993222855bc4 Reviewed-on: https://go-review.googlesource.com/c/website/+/603717 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Michael Pratt <mpratt@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Auto-Submit: Michael Pratt <mpratt@google.com>
Change https://go.dev/cl/605175 mentions this issue: |
This change: Removes the draft notice from go1.23.md Updates the deployment for golangorg to Go 1.23 Adds Go 1.23 to history/release.go For golang/go#65614 Change-Id: I5afe34461fdb764b8f9759b0b8d894f72532ecf1 Reviewed-on: https://go-review.googlesource.com/c/website/+/605175 Reviewed-by: David Chase <drchase@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Change https://go.dev/cl/605875 mentions this issue: |
Fixes golang/go#68891 For golang/go#64207 For golang/go#65614 Change-Id: I9256d9de0687b9e3cf674b4d318f4d5023a9bf16 Reviewed-on: https://go-review.googlesource.com/c/website/+/605875 Reviewed-by: Carlos Amedee <carlos@golang.org> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
This is the tracking issue for writing the Go 1.23 Release Notes. The version at tip can be viewed at https://tip.golang.org/doc/go1.23.
This is the first release to use the improved release note process being implemented in #64169. Also see a corresponding golang-dev thread. (CC @jba.)
Up until the the end of the development cycle (end of May), release note fragments are added inside the doc/next directory in the main Go repo. This is documented in the "For developers" section of doc/README.md:
https://go.googlesource.com/go/+/HEAD/doc/#for-developers
At the end of the development cycle, the doc/next files will be merged into a single go1.23.md file, and all remaining edits will take place in it. This merge will be handled as part of the Go release process.
The previous issue was #61422.
The text was updated successfully, but these errors were encountered: