doc: write release notes for Go 1.24

[dmitshur]

This is the tracking issue for writing the Go 1.24 Release Notes. The version at tip can be viewed at https://tip.golang.org/doc/go1.24.

When the Go 1.24 Release Notes are complete, this should be closed, and a similar issue should be made for the next release. The previous issue was #65614.

A partial list of changes that were known on 2024-11-26 to need to be added the release notes:

• cmd/go: define HTTP authentication extension mechanism #26232
• spec: generics: permit type parameters on aliases #46477
• cmd/go: track tool dependencies in go.mod #48429
• cmd/go: stamp the pseudo-version in builds generated by go build #50603
• cmd/cgo: add #cgo noescape/nocallback annotations #56378
• cmd/vet: report printf calls with non-const format and no args #60529
• cmd/vet: consider reporting invalid/ignored Go versions in build tags #64127
• cmd/compile: add go:wasmexport directive #65199
• cmd/vet: warn on 3-clause loops where an iterator variable contains a lock type when GoVersion>=1.22 #66387
• cmd/go: cache link output binaries in the build cache #69290
• crypto/tls: automatic CurvePreferences ordering #69393
• cmd/link: LC_UUID not generated by go linker, resulting in failure to access local network on macOS 15 #68678
• cmd/link: document that on ELF, GNU build ID is now generated by default #70586

[gabyhelp]

Related Issues and Documentation

• doc: write release notes for Go 1.22 #61422 (closed)
• doc: write release notes for Go 1.23 #65614
• doc: write Go 1.14 release notes #36878 (closed)
• doc: write release notes for Go 1.21 #58645 (closed)
• doc: write Go 1.20 release notes #54202 (closed)
• doc: write Go 1.16 release notes #40700 (closed)
• doc: write Go 1.15 release notes #37419 (closed)
• doc: write Go 1.18 release notes #47694 (closed)
• doc: write Go 1.19 release notes #51400 (closed)
• doc: write Go 1.17 release notes #44513 (closed)

_{(Emoji vote if this was helpful or unhelpful; more detailed feedback welcome in this discussion.)}

[gopherbot]

Change https://go.dev/cl/600177 mentions this issue: doc: initialize next directory for Go 1.24

[gopherbot]

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

[gopherbot]

Change https://go.dev/cl/600656 mentions this issue: doc/next: use relative link to Go issue

[gopherbot]

Change https://go.dev/cl/605615 mentions this issue: doc/next: document version stamping for go builds within a Git Repo

[gopherbot]

Change https://go.dev/cl/622015 mentions this issue: doc/next: document the minimum Linux kernel version for 1.24

[gopherbot]

Change https://go.dev/cl/631682 mentions this issue: doc/next: add release note for vet on Printf(s) with non-const s

[gopherbot]

Change https://go.dev/cl/635597 mentions this issue: _content/doc/go1.24: normalize how GODEBUG settings are referred to

[gopherbot]

Change https://go.dev/cl/635598 mentions this issue: _content/doc/go1.24: reword VCS version stamping note

[gopherbot]

Change https://go.dev/cl/635596 mentions this issue: _content/doc/go1.24: minor nits

[cagedmantis]

Thanks to everybody who have worked diligently to complete this draft of the release notes.

[cagedmantis]

The Go 1.24 Release Notes draft is complete, and all known TODOs have been resolved. Adding okay-after-rc1.

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

• Any additional copy-editing and other improvements.
  • Not in the release notes but documentation related: improvements to encoding documentation.
• On the Go 1.24.0 release day, remove the draft notice.

[gopherbot]

Change https://go.dev/cl/636519 mentions this issue: _content/doc/go1.24: add objdump updates

[gopherbot]

Change https://go.dev/cl/638296 mentions this issue: _content/doc/go1.24: fix meaning of -u in 'go get -u tool'

[andig]

Change https://go.dev/cl/638296 reads

There are various other details that could be covered, like the -u or -t
flags, or that 'go get tool' is a shorthand for 'go get tool@upgrade',

Using

go help get | grep "@upgrade"

Does not show anything. Yet

go get all@upgrade

does execute. Is anything missing from the docs regarding @upgrade in general?

[dmitshur]

@andig The go help get text describes the go get command and provides help on using it, but it doesn't attempt to provide complete coverage for all details. For that, it refers the reader to reference documentation:

$ go help get | grep '[Ss]ee'
See https://golang.org/ref/mod#go-get for details.
See 'go help install' or https://golang.org/ref/mod#go-install for details.
For more about build flags, see 'go help build'.
For more about modules, see https://golang.org/ref/mod.
suggested Go toolchain, see https://go.dev/doc/toolchain.
For more about specifying packages, see 'go help packages'.
See 'go help gopath-get'.
See also: go build, go install, go clean, go mod.

In this case, the https://go.dev/ref/mod#go-get section of the Go module reference is where the @upgrade version query suffix is documented, with that section itself also linking to https://go.dev/ref/mod#version-queries for remaining details.

[cherrymui]

The release notes still have TODO comments

<!-- #### [`crypto/fips140`](/pkg/crypto/fips140/)

TODO: FIPS 140 will be covered in its own section.
TODO: accepted [proposal #70200](/issue/70200) (from [CL 629196](/cl/629196), [CL 629198](/cl/629198), [CL 629201](/cl/629201), [CL 629996](/cl/629996))
TODO: crypto/tls FIPS mode from CL 629675. -->

which are not addressed.

Currently there is no mentioning of FIPS 140 (or fips140) in the release notes.

@FiloSottile @rolandshoemaker @rsc could you help write this? Thanks!

[FiloSottile]

Currently there is no mentioning of FIPS 140 (or fips140) in the release notes.

@FiloSottile @rolandshoemaker @rsc could you help write this? Thanks!

Yep, will mail today or early tomorrow.

[gopherbot]

Change https://go.dev/cl/647856 mentions this issue: _content/doc/go1.24: clean up the "Maybe worth including" section

[gopherbot]

Change https://go.dev/cl/647855 mentions this issue: _content/doc/go1.24: don't refer to parameter names in release notes

[gopherbot]

Change https://go.dev/cl/647797 mentions this issue: _content/doc/go1.24: remove draft notice

[gopherbot]

Change https://go.dev/cl/648498 mentions this issue: cmd/golangorg, internal/history: update for Go 1.24.0 release