From: Jonathan Amsterdam Date: Wed, 15 Nov 2023 13:23:23 +0000 (-0500) Subject: doc/README.md: explain new release note system X-Git-Tag: go1.23rc1~1426 X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=b3cfb24f8d19e402b5f03f28777af2a27dd65658;p=gostls13.git doc/README.md: explain new release note system This is the first CL in a sequence that adds support for generating release notes from fragments. The actual generator will live elsewhere, in x/build. This repo will hold the content and some validity checks. For #64169. Change-Id: Iaa8d9ad96393ab9433170b3cfa47334837f3f691 Reviewed-on: https://go-review.googlesource.com/c/go/+/542515 Reviewed-by: Dmitri Shuralyov LUCI-TryBot-Result: Go LUCI Reviewed-by: Dmitri Shuralyov --- diff --git a/doc/README.md b/doc/README.md new file mode 100644 index 0000000000..827af1d3b1 --- /dev/null +++ b/doc/README.md @@ -0,0 +1,26 @@ +# Release Notes + +The `initial` and `next` subdirectories of this directory are for release notes. + +At the start of a release development cycle, the contents of `next` should be deleted +and replaced with those of `initial`. +Release notes should be added to `next` by editing existing files or creating new files. + +To prepare the release notes for a release, run `golang.org/x/build/cmd/relnote generate`. +That will merge the `.md` files in `next` into a single file. + +The files are merged by being concatenated in sorted order by pathname. Files in +the directory matching the glob "*stdlib/*minor" are treated specially. They should +be in subdirectories corresponding to standard library package paths, and headings +for those package paths will be generated automatically. + +Files in this repo's `api/next` directory must have corresponding files in `*stdlib/*minor`. +The files should be in the subdirectory for the package with the new API, and should +be named after the issue number of the API proposal. For example, for an api/next +file with the line + + pkg net/http, function F #12345 + +there should be a file named net/http/12345.md. +At a minimum, that file should contain either a full sentence or a TODO, +ideally referring to a person with the responsibility to complete the note.