aboutsummaryrefslogtreecommitdiff
path: root/doc/README.md
AgeCommit message (Collapse)Author
4 daysdoc: mark range-over-func as documentedDmitri Shuralyov
The language change for the accepted range-over-func proposal #61405 was documented in CL 590616. Remove the corresponding 'TODO' entry. Also improve formatting slightly, and switch to preferred relative links. They'll work better in the long term and in more contexts. While here, also simplify the suggested line to preview release notes locally: setting the -content='' flag explicitly is no longer required as of CL 589936. For #65614. Change-Id: I6cee951b9ede33900bca48c9f709e3b2c5e87337 Reviewed-on: https://go-review.googlesource.com/c/go/+/590756 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: Robert Griesemer <gri@google.com>
2024-05-24doc/README: suggest a way to preview next content, tweak release stepsDmitri Shuralyov
Smaller edits are usually fine to do without previewing, since Markdown can be intuitive. But for larger changes including re-ordering sections and such, it can be helpful to quickly see the end result. Write down a way to do that. Update the release steps to capture that the doc/next content will move to x/website before RC 1, when the complete release note draft is ready. For #64169. Change-Id: Ie554ed5294ce819fd0689e2249e6013826f0c71f Reviewed-on: https://go-review.googlesource.com/c/go/+/587922 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> TryBot-Bypass: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Jonathan Amsterdam <jba@google.com>
2024-05-16doc/README.md: give example of package-less symbol linkJonathan Amsterdam
Change-Id: I84d7b6aae7319cc62628a2b5ee752a0680377a15 Reviewed-on: https://go-review.googlesource.com/c/go/+/586135 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>
2024-05-16doc/README.md: mention adding the proposal issueJonathan Amsterdam
Inform users that every accepted proposal should be mentioned in the release notes to avoid generating a TODO. Also, clarify instructions for the release team. For #64169. Change-Id: I03921739af31fc93f4b5808b2c7c98e28ad3da11 Reviewed-on: https://go-review.googlesource.com/c/go/+/584615 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>
2024-04-26doc/README.md: discourage RELNOTE in CLsJonathan Amsterdam
Release notes should always be files under doc/next. Make it clear that this is the only way to add them: RELNOTE markers in CLs are no longer supported. Change-Id: I34d77eb876f57b84ecdc7e5ecbf3eb5c91e6fed8 Reviewed-on: https://go-review.googlesource.com/c/go/+/582075 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> TryBot-Bypass: Jonathan Amsterdam <jba@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2024-04-10doc/README.md: note simpler symbol linksJonathan Amsterdam
Document that links to symbols in the standard library can be written as "[foo]", without the actual link. For #64169. Change-Id: I9d8a33e85df70037320a169d55a2bb4a8a981ebf Reviewed-on: https://go-review.googlesource.com/c/go/+/577915 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
2024-01-30doc/README: clarify instructionsAlan Donovan
- State that new markdown files belong in doc/next. - Give hints on correct markdown syntax. For #64169 Change-Id: Ied70e7ac443530c910eea2992ca6e303bbc10499 Reviewed-on: https://go-review.googlesource.com/c/go/+/558855 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> Reviewed-by: Jonathan Amsterdam <jba@google.com>
2024-01-24doc/next: initial contentsJonathan Amsterdam
Initialize the doc/next directory for the next release by copying the contents of doc/initial into it. Also, rewrite doc/README.md to add release instructions and to separate information for developers from information for the release team. Change-Id: Ie1e5c2ddae7a8d301e9b2f8a68925519648aa84d Reviewed-on: https://go-review.googlesource.com/c/go/+/557535 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> Reviewed-by: Jonathan Amsterdam <jba@google.com>
2024-01-22doc/README.md: explain new release note systemJonathan Amsterdam
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 <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>