Skip to content

doc: describe/summarize error value features in the Go 1.13 release notes #33365

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.

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

Closed
cespare opened this issue Jul 30, 2019 · 4 comments
Closed
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. release-blocker
Milestone

Comments

@cespare
Copy link
Contributor

cespare commented Jul 30, 2019

The error value changes landing in Go 1.13 are one piece of the headline Go 2 "better error handling" improvements. However, the only mention in the Go 1.13 release notes right now is a short list of the new functions in the "Minor changes to the library" section.

I think these changes are important enough to warrant a description/summary at the top level of the release notes. Perhaps we should link to the design or mention the expected upcoming changes that will also tie in. Additionally, if we expect people to be adopting these features widely, perhaps we should include some prescriptive language to that end. (Or will there be a blog post?)

This is related to #33364, where the new features are also inadequately described in the package documentation.

/cc @jba @neild

@cespare cespare added Documentation Issues describing a change to documentation. release-blocker labels Jul 30, 2019
@cespare cespare added this to the Go1.13 milestone Jul 30, 2019
@katiehockman katiehockman added the NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. label Jul 31, 2019
@katiehockman
Copy link
Contributor

/cc @andybons @mpvl

@ianlancetaylor
Copy link
Contributor

@jba Want to work on this issue along with your revamp of the errors package doc?

@jba jba self-assigned this Aug 2, 2019
@jba
Copy link
Contributor

jba commented Aug 2, 2019

Sure.

@gopherbot
Copy link
Contributor

Change https://golang.org/cl/188798 mentions this issue: go1.13.html: describe error-value additions

@golang golang locked and limited conversation to collaborators Aug 4, 2020
@rsc rsc unassigned jba Jun 23, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Documentation Issues describing a change to documentation. FrozenDueToAge NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. release-blocker
Projects
None yet
Development

No branches or pull requests

5 participants