doc, x/website: move "Release History" content to x/website #36075
Labels
Documentation
FrozenDueToAge
NeedsFix
The path to resolution is known, but the work has not been done.
Milestone
I plan to move the Release History page (along with two other pages in https://golang.org/doc/devel/ with pre-Go 1 history) from the main Go repository to the x/website repository. This is a subset of #29206, and this change will help improve the Go release process. The background section elaborates on the benefits.
This is the tracking issue. Relevant steps:
releasebot
to not check doc/devel/release.html for new entry in Go repo as a blocking step (CL 210957)Background
When making minor Go releases, the first time-intensive automated step in the release process is the
releasebot -mode=prepare
command. Before it can be started, the Release History page needs to be updated to include the two new minor versions. This involves creating, reviewing, and submitting 5 CLs in the main repository:This is more expensive, time intensive, and error prone than it could be made today. There are two reasons why it was originally done this way:
Point 1 is no longer true. We have changed the canonical website from x/tools/cmd/godoc to x/website/cmd/golangorg (see issues 29206 and 32011). godoc’s website content is becoming stale.
Point 2 is no longer true for Go 1.13 and newer. Go 1.12 was the last release that bundled the godoc command as part of the binary distribution.
After this change, the process of creating, reviewing, and submitting 5 CLs to the main repository before the release can be cut will be replaced with a single step that can be done asynchronously (e.g., while a long-running automated command is running):
During the time that Go 1.12 is still supported (until Go 1.14 is released), we will also need to update its release branch because it has an old godoc bundled that displays the website.
/cc @toothrot @cagedmantis @andybons @jayconrod @rsc
The text was updated successfully, but these errors were encountered: