doc: write release notes for Go 1.21
thanm opened this issue · 27 comments
This is the tracking issue for writing the Go 1.21 Release Notes. The version at tip can be viewed at https://tip.golang.org/doc/go1.21.
When the Go 1.21 Release Notes are complete, this should be closed, and a similar issue should be made for the next release. Previous issues are #54202, #51400, #47694, #44513, etc.
Change https://go.dev/cl/470296 mentions this issue: doc: start draft Go 1.21 release notes
Change https://go.dev/cl/495775 mentions this issue: doc/go1.21: convert .html to .md
Change https://go.dev/cl/496116 mentions this issue: doc: release notes for my humble contributions to go1.21
Change https://go.dev/cl/496316 mentions this issue: doc: add TODOs to go1.21
Change https://go.dev/cl/496194 mentions this issue: doc: add slog to release notes
Change https://go.dev/cl/497095 mentions this issue: doc: write various runtime-related release notes
Change https://go.dev/cl/498263 mentions this issue: doc: release notes for PGO devirtualization
Change https://go.dev/cl/498575 mentions this issue: doc: add release note on dead global map variable deletion
Change https://go.dev/cl/499282 mentions this issue: doc/go1.21: document type inference changes
Change https://go.dev/cl/499637 mentions this issue: doc/go1.21: crypto release notes
Change https://go.dev/cl/499716 mentions this issue: doc/go1.21: mention improvement to C-to-Go calls
Change https://go.dev/cl/500239 mentions this issue: doc/go1.21: document macOS and Windows requirements
Change https://go.dev/cl/501695 mentions this issue: doc/go1.21: run relnotes again
Change https://go.dev/cl/501825 mentions this issue: doc/go1.21: add heading for cmp package
Change https://go.dev/cl/502696 mentions this issue: doc/go1.21: clean up remaining TODOs
Change https://go.dev/cl/505436 mentions this issue: doc/go1.21: document changes in crypto/tls related to client authentication alerts
Change https://go.dev/cl/510375 mentions this issue: doc: run relnotes again
Change https://go.dev/cl/511317 mentions this issue: [release-branch.go1.21] doc: delete go1.21.html copy
Change https://go.dev/cl/513475 mentions this issue: doc/go1.21: finish last TODO for go/types.Package.GoVersion
Writing down a few of the known remaining tasks needed to close out this release-blocking issue:
- resolve a
go/typesTODO still visible at https://tip.golang.org/doc/go1.21#go/types- https://go.dev/cl/513475 resolves it and is submitted
- review remaining open CLs that are updating doc/go1.21.html (https://go-review.googlesource.com/q/path:doc/go1.21.html+status:open+-label:Hold%3D%252B1)
- move doc/go1.21.html from main Go repo to x/website/_content/doc (like CL 464075 and CL 464055 did it for 1.20 release notes)
- run relnote for the last time to find out whether any additional changes have been flagged for release notes
- on release day itself, delete the "Go 1.21 is not yet released. These are work-in-progress release notes. Go 1.21 is expected to be released in August 2023." notice (this is in scope of the go1.21.0 release process itself)
- The CL removing that draft notice will also mark this issue closed.
Change https://go.dev/cl/516075 mentions this issue: doc: move Go 1.21 release notes to x/website
Change https://go.dev/cl/516095 mentions this issue: _content/doc: add Go 1.21 release notes
Backlink to TODO list at #58645 (comment) since otherwise it gets lost in the "hidden items".
Change https://go.dev/cl/517035 mentions this issue: internal/history: add Go 1.21, remove release notes draft notice