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.

Comment From: gopherbot

Change https://go.dev/cl/563856 mentions this issue: doc/go1.23: document macOS requirements

Comment From: gopherbot

Change https://go.dev/cl/568755 mentions this issue: doc/go1.23: document database/sql wrap errors

Comment From: jfrech

I think 3c78ace24f3aa025a72b53be3b83423f9f24ee5d's changes are worth mentioning.

Comment From: ianlancetaylor

@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.

Comment From: gopherbot

Change https://go.dev/cl/587415 mentions this issue: doc/initial, doc/next: add draft notice to introduction

Comment From: gopherbot

Change https://go.dev/cl/587436 mentions this issue: cmd/golangorg: add doc/next page to preview draft release notes

Comment From: gopherbot

Change https://go.dev/cl/587695 mentions this issue: doc/next: document go mod tidy -diff flag

Comment From: gopherbot

Change https://go.dev/cl/588015 mentions this issue: doc/next: populate TODOs found with relnote todo

Comment From: gopherbot

Change https://go.dev/cl/588057 mentions this issue: _content/doc: add go1.23.md placeholder

Comment From: gopherbot

Change https://go.dev/cl/587927 mentions this issue: doc: add release notes for a couple minor tracing features

Comment From: gopherbot

Change https://go.dev/cl/589015 mentions this issue: doc/next: preannounce a new Linux kernel version requirement

Comment From: gopherbot

Change https://go.dev/cl/589216 mentions this issue: doc/next: document proposal 62518 as not relevant

Comment From: gopherbot

Change https://go.dev/cl/590616 mentions this issue: doc: document "range-over-func" language change in release notes

Comment From: gopherbot

Change https://go.dev/cl/590617 mentions this issue: doc: document GOEXPERIMENT=aliastypeparams in release notes

Comment From: gopherbot

Change https://go.dev/cl/590795 mentions this issue: doc/next: mention new error on time.Parse timezone overflow

Comment From: gopherbot

Change https://go.dev/cl/590756 mentions this issue: doc: mark range-over-func as documented

Comment From: gopherbot

Change https://go.dev/cl/590895 mentions this issue: doc: document new default for GODEBUG gotypesalias setting in release notes

Comment From: gopherbot

Change https://go.dev/cl/591380 mentions this issue: doc/next: add release notes for telemetry and the godebug directive

Comment From: gopherbot

Change https://go.dev/cl/591875 mentions this issue: doc/next: document GOARM64 environment variable

Comment From: gopherbot

Change https://go.dev/cl/591896 mentions this issue: doc/next: resolve a TODO for openbsd/riscv64 port

Comment From: gopherbot

Change https://go.dev/cl/591895 mentions this issue: doc/next: document GORISCV64 environment variable

Comment From: gopherbot

Change https://go.dev/cl/591898 mentions this issue: doc/next: document locking down linkname usages

Comment From: gopherbot

Change https://go.dev/cl/591899 mentions this issue: doc/next: reword linker -bindnow release notes

Comment From: dmitshur

Rerunning relnote todo today doesn't find more TODOs beyond the 4 already added to the source (view-source:https\://tip.golang.org/doc/go1.23).

relnote todo output
$ cd gotip 
gotip $ git status
On branch main
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean
gotip $ git pull --ff-only 
Already up to date.

gotip $ go run golang.org/x/build/cmd/relnote@latest -goroot=. todo
relnote: collecting TODOs from . since 2024-01-19
[...]
<!-- TODO: Improve the wording. Mention the tlskyber GODEBUG. --> (from 6-stdlib/99-minor/crypto/tls/67061.md:1)
<!-- TODO: Improve this if needed. --> (from 3-tools.md:22)
<!-- TODO: document Go 1.23 behavior (from https://go.dev/cl/559199, https://go.dev/cl/559519, https://go.dev/cl/559795, https://go.dev/cl/562715, https://go.dev/cl/562735, https://go.dev/cl/564555, https://go.dev/cl/570679, https://go.dev/cl/570736, https://go.dev/cl/582695, https://go.dev/cl/584276, https://go.dev/cl/585235, https://go.dev/cl/586138) --> (from 3-tools.md:34)
<!-- TODO: document Go 1.23 behavior (from https://go.dev/cl/584218, https://go.dev/cl/584300, https://go.dev/cl/584475, https://go.dev/cl/584476) --> (from 3-tools.md:37)

Comment From: gopherbot

Change https://go.dev/cl/592195 mentions this issue: doc/next: reword map iterator function notes

Comment From: gopherbot

Change https://go.dev/cl/592196 mentions this issue: doc/next: improve wording for proposal 67061

Comment From: gopherbot

Change https://go.dev/cl/592197 mentions this issue: doc/next: improve description of proposal 61308

Comment From: gopherbot

Change https://go.dev/cl/593495 mentions this issue: doc/next: update release notes for go list -m -json

Comment From: dmitshur

The Go 1.23 Release Notes draft is complete, and all known TODOs have been resolved. Running relnote todo right now doesn't find anything remaining beyond proposal #61940, which doesn't need to be mentioned. Adding okay-after-rc1.

This issue now tracks the remaining post-RC 1 work:

  • any additional copy-editing and other improvements
  • [x] merge fragments and move draft to x/website (CL 594035 + CL 594036)
  • [ ] on the Go 1.23.0 release day, remove the draft notice

Comment From: gopherbot

Change https://go.dev/cl/594035 mentions this issue: _content/doc: add merged go1.23.md

Comment From: gopherbot

Change https://go.dev/cl/594036 mentions this issue: doc/next: delete

Comment From: gopherbot

Change https://go.dev/cl/595959 mentions this issue: _content/doc/go1.23: remove minor package changes with no content

Comment From: gopherbot

Change https://go.dev/cl/599775 mentions this issue: _content/doc/go1.23: minor format change

Comment From: gopherbot

Change https://go.dev/cl/600936 mentions this issue: _content/doc/go1.23: document known issue for generic alias types

Comment From: gopherbot

Change https://go.dev/cl/601995 mentions this issue: _content/doc/go1.23: fix a typo and some formatting

Comment From: gopherbot

Change https://go.dev/cl/603717 mentions this issue: _content/doc/go1.23: os: document pidfd

Comment From: gopherbot

Change https://go.dev/cl/605175 mentions this issue: internal/history: remove draft notice, update deployment, add Go 1.23

Comment From: gopherbot

Change https://go.dev/cl/605875 mentions this issue: internal/dl: require macos 11