Skip to content
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.

Sign up for GitHub

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

Jump to bottom

doc: write release notes for Go 1.24 #68545

Open
dmitshur opened this issue Jul 22, 2024 · 35 comments
Open

doc: write release notes for Go 1.24 #68545

dmitshur opened this issue Jul 22, 2024 · 35 comments
Labels
Documentation NeedsFix The path to resolution is known, but the work has not been done. release-blocker
Milestone
Go1.24

Comments

@dmitshur
Copy link
Contributor

dmitshur commented Jul 22, 2024 •
edited
Loading

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:
@dmitshur dmitshur added Documentation NeedsFix The path to resolution is known, but the work has not been done. release-blocker labels Jul 22, 2024
@dmitshur dmitshur added this to the Go1.24 milestone Jul 22, 2024
@gabyhelp
Copy link

Related Issues and Documentation

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

@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit that referenced this issue Jul 22, 2024
@dmitshur @gopherbot
doc: initialize next directory for Go 1.24
e8c5bed 
Following the "For the release team" steps in README:

	cd doc
	cp -R initial/ next
	$EDITOR next/1-intro.md

Dropped '*' from the cp -R command to avoid needing to
create an empty next directory with a separate command.

For #68545.
For #67586.

Change-Id: I25215bc35a043e0f26d4a86ffe66eb3c26348fef
Reviewed-on: https://go-review.googlesource.com/c/go/+/600177
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: Cherry Mui <cherryyz@google.com>
@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit to golang/website that referenced this issue Jul 22, 2024
@dmitshur @gopherbot
_content/doc: add go1.24.md placeholder
ed6d739 
Add this file now so that it's possible to preview the latest release
notes draft at https://tip.golang.org/doc/go1.24, and to include that
link in the tracking issue. Based on CL 588057 that did this for 1.23.

For golang/go#68545.

Change-Id: I07f30023d23ec027927f7417ebece4110f221efa
Reviewed-on: https://go-review.googlesource.com/c/website/+/600179
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Cherry Mui <cherryyz@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit that referenced this issue Jul 24, 2024
@dmitshur @gopherbot
doc/next: use relative link to Go issue
792a261 
The Go release notes are served on multiple domains (go.dev,
golang.google.cn, tip.golang.org, localhost:8080 and so on), so links
pointing to the Go website itself need to be relative to work in all
those contexts.

Caught by a test in x/website. The next CL adds the same test to this
repository so these kinds of problems are caught sooner and with less
friction.

For #68545.
Fixes #68575.

Change-Id: I08056b98968c77a1d0ed93b63fccfbe41274ec8f
Reviewed-on: https://go-review.googlesource.com/c/go/+/600656
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Ian Lance Taylor <iant@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
@gopherbot
Copy link
Contributor

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

@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit that referenced this issue Oct 23, 2024
@cagedmantis @gopherbot
doc/next: document the minimum Linux kernel version for 1.24
6ea87f9 
The minimum Linux kernel version for Go 1.24 is now set to 3.2.

Updates #67001
For #68545

Change-Id: I509f09c8ed7f3067af14066cf139008db0cb06ba
Reviewed-on: https://go-review.googlesource.com/c/go/+/622015
Auto-Submit: Carlos Amedee <carlos@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
This was referenced Nov 26, 2024
Closed
Closed
Closed
Closed
Closed
Closed
@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit that referenced this issue Nov 26, 2024
@adonovan @gopherbot
doc/next: add release note for vet on Printf(s) with non-const s
0751f3a 
Fixes #60529
Updates #68545

Change-Id: Ica048e4861f4de22deb7f42a1d76eb3151fee986
Reviewed-on: https://go-review.googlesource.com/c/go/+/631682
Auto-Submit: Alan Donovan <adonovan@google.com>
Reviewed-by: Robert Findley <rfindley@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
This was referenced Nov 26, 2024
Closed
Closed
Closed
Closed
Closed
Closed
Open
Closed
gopherbot pushed a commit to golang/website that referenced this issue Dec 6, 2024
@samthanawalla @gopherbot
_content/doc: add release notes for GOAUTH
6046253 
For: golang/go#26232
For: golang/go#68545

Change-Id: If5081ffdd69f4c62055180ed80f30b97c3c2126c
Reviewed-on: https://go-review.googlesource.com/c/website/+/634235
Auto-Submit: Sam Thanawalla <samthanawalla@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Michael Matloob <matloob@golang.org>
gopherbot pushed a commit to golang/website that referenced this issue Dec 6, 2024
@samthanawalla @gopherbot
_content/doc: add release notes for version stamping go builds
a379667 
Fixes: golang/go#50603
For: golang/go#68545

Change-Id: Id4dd8a41549763297064317db8847db73b8bff8f
Reviewed-on: https://go-review.googlesource.com/c/website/+/633856
Reviewed-by: Michael Matloob <matloob@golang.org>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Sam Thanawalla <samthanawalla@google.com>
@gopherbot
Copy link
Contributor

Change https://go.dev/cl/634275 mentions this issue: _content/doc: add release notes for toolchaintrace

@gopherbot
Copy link
Contributor

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

@gopherbot
Copy link
Contributor

Change https://go.dev/cl/634797 mentions this issue: _content/doc/go1.24: improve hash/maphash release notes

gopherbot pushed a commit to golang/website that referenced this issue Dec 10, 2024
@cherrymui
_content/doc/go1.24: improve hash/maphash release notes
6a17f90 
Don't refer to identifiers, which are not present in the release
notes.

For golang/go#68545.

Change-Id: I7a9e5f1e024995c32247313d2c83f98b96327609
Reviewed-on: https://go-review.googlesource.com/c/website/+/634797
Reviewed-by: David Chase <drchase@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
gopherbot pushed a commit to golang/website that referenced this issue Dec 10, 2024
@cherrymui
_content/doc/go1.24: minor updates
8e64cd8 
A minor grammer fix and a minor format fix.

For golang/go#68545.

Change-Id: I474319b16ef5168de752aa253d0a167142992d92
Reviewed-on: https://go-review.googlesource.com/c/website/+/634798
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
@gopherbot
Copy link
Contributor

Change https://go.dev/cl/635275 mentions this issue: _content/doc: update runtime.AddCleanup note

@gopherbot
Copy link
Contributor

Change https://go.dev/cl/635216 mentions this issue: _content/doc/go1.24: remove release-blocking issues that are resolved

gopherbot pushed a commit to golang/website that referenced this issue Dec 11, 2024
@dmitshur @gopherbot
_content/doc/go1.24: remove release-blocking issues that are resolved
193b880 
Also incorporate output of 'relnote todo' on fragments that were moved
in CL 634056 and CL 634057.

For golang/go#68545.

Change-Id: I1d4ced29282913061596998da018f66bba6ffa8c
Reviewed-on: https://go-review.googlesource.com/c/website/+/635216
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Carlos Amedee <carlos@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
gopherbot pushed a commit to golang/website that referenced this issue Dec 11, 2024
@samthanawalla @gopherbot
_content/doc: add release notes for toolchaintrace
6ec293f 
For: golang/go#63939
Updates: golang/go#68545
Change-Id: I1ee3eae7dd93e09350ebc2febe19535adbbf8a76
Reviewed-on: https://go-review.googlesource.com/c/website/+/634275
Auto-Submit: Sam Thanawalla <samthanawalla@google.com>
Reviewed-by: Michael Matloob <matloob@golang.org>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
gopherbot pushed a commit to golang/website that referenced this issue Dec 11, 2024
@cagedmantis @gopherbot
_content/doc: update runtime.AddCleanup note
41b60ae 
For golang/go#68545
For golang/go#67535

Change-Id: I8d15c5645a50a50a035b3c531a6ceb4324e26364
Reviewed-on: https://go-review.googlesource.com/c/website/+/635275
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Carlos Amedee <carlos@golang.org>
Reviewed-by: Cherry Mui <cherryyz@google.com>
@gopherbot
Copy link
Contributor

Change https://go.dev/cl/635340 mentions this issue: _content/doc/go1.24: use backticks for GOAUTH

gopherbot pushed a commit to golang/website that referenced this issue Dec 12, 2024
@danp @gopherbot
_content/doc/go1.24: use backticks for GOAUTH
48fe618 
For: golang/go#26232
For: golang/go#68545

Change-Id: I31fe54bee06a574dfce9335ac65f5d5b98fef756
Reviewed-on: https://go-review.googlesource.com/c/website/+/635340
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Reviewed-by: Ian Lance Taylor <iant@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Ian Lance Taylor <iant@google.com>
@gopherbot
Copy link
Contributor

Change https://go.dev/cl/635595 mentions this issue: _content/doc/go1.24: extend, fix, and cleanup crypto release notes

@gopherbot
Copy link
Contributor

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

@gopherbot
Copy link
Contributor

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

@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit to golang/website that referenced this issue Dec 12, 2024
@FiloSottile @gopherbot
_content/doc/go1.24: extend, fix, and cleanup crypto release notes
22adbef 
FIPS 140 commented out for now, will add a section in a follow-up CL.
It's ok for those to come after rc1, also because it's a bit unclear yet
what we can assert about the FIPS 140-3 status of the release. Note that
none of the changes affect existing programs that don't opt in with the
new switches.

For golang/go#68545

Change-Id: I9779a0976127e5fdc65b4b8ae3c6c2de4739390b
Reviewed-on: https://go-review.googlesource.com/c/website/+/635595
Auto-Submit: Filippo Valsorda <filippo@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Reviewed-by: Roland Shoemaker <roland@golang.org>
Reviewed-by: Daniel McCarney <daniel@binaryparadox.net>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
gopherbot pushed a commit to golang/website that referenced this issue Dec 12, 2024
@FiloSottile @gopherbot
_content/doc/go1.24: minor nits
278ac22 
For golang/go#68545

Change-Id: Ie32bb7d09038fb13f738f60d8be99aa6eed69d37
Reviewed-on: https://go-review.googlesource.com/c/website/+/635596
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Auto-Submit: Filippo Valsorda <filippo@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Sam Thanawalla <samthanawalla@google.com>
@cagedmantis
Copy link
Contributor

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

@cagedmantis
Copy link
Contributor

cagedmantis commented Dec 12, 2024 •
edited by gabyhelp
Loading

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.

@cagedmantis cagedmantis added the okay-after-rc1 Used by release team to mark a release-blocker issue as okay to resolve either before or after rc1 label Dec 12, 2024
gopherbot pushed a commit to golang/website that referenced this issue Dec 12, 2024
@FiloSottile @gopherbot
_content/doc/go1.24: normalize how GODEBUG settings are referred to
4cfc485 
For golang/go#68545

Change-Id: Ic994abed61389823e261c4c4e1b66f0502f3466a
Reviewed-on: https://go-review.googlesource.com/c/website/+/635597
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Filippo Valsorda <filippo@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Carlos Amedee <carlos@golang.org>
gopherbot pushed a commit to golang/website that referenced this issue Dec 12, 2024
@FiloSottile @gopherbot
_content/doc/go1.24: reword VCS version stamping note
2a8b895 
I struggled to map the old ones to the behavior described in
golang/go#50603: a pseudo-version will be generated even if a VCS tag is
available, but is not the latest commit.

Also, a link to BuildInfo.Main feels useful.

For golang/go#68545

Change-Id: Id2642c94a18e22ac56439728f20f01bf87d14a70
Reviewed-on: https://go-review.googlesource.com/c/website/+/635598
Reviewed-by: Sam Thanawalla <samthanawalla@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Sam Thanawalla <samthanawalla@google.com>
Auto-Submit: Filippo Valsorda <filippo@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Reviewed-by: Michael Matloob <matloob@golang.org>
@gopherbot gopherbot removed the okay-after-rc1 Used by release team to mark a release-blocker issue as okay to resolve either before or after rc1 label Dec 13, 2024
@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit to golang/website that referenced this issue Dec 16, 2024
@cherrymui
_content/doc/go1.24: add objdump updates
ad6037a 
The objdump tool now supports dissassembly on riscv64, loong64,
and s390x.

Updates golang/go#15255, golang/go#36738.
For golang/go#68545.

Change-Id: I5e913eb27383f42777baac1cd8436a5c6eb629fd
Reviewed-on: https://go-review.googlesource.com/c/website/+/636519
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>
@gopherbot
Copy link
Contributor

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

gopherbot pushed a commit to golang/website that referenced this issue Dec 23, 2024
@thepudds @gopherbot
_content/doc/go1.24: fix meaning of -u in 'go get -u tool'
abd3201 
It's a common misperception that -u is needed more often than it is,
perhaps in part due to muscle memory from the GOPATH days.

The current release notes suggest that 'go get -u tool' will upgrade all
of the current module's tools, but it does more than that -- it will
also upgrade all of the direct and indirect non-test dependencies of
those tools too.

The simplest fix is probably just to remove the -u from this section of
the release notes.

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',
but maybe this is sufficient.

Updates golang/go#48429
Updates golang/go#68545

Change-Id: I31eeb96dae996a7ffde24d9bae6788d6889e2044
Reviewed-on: https://go-review.googlesource.com/c/website/+/638296
Reviewed-by: David Chase <drchase@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Conrad Irwin <conrad.irwin@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
Documentation NeedsFix The path to resolution is known, but the work has not been done. release-blocker
Projects
None yet
Milestone
Go1.24
Development

No branches or pull requests
4 participants
@cagedmantis @dmitshur @gopherbot @gabyhelp