The most helpful "official" reference is on the wiki at https://github.com/golang/go/wiki/Deprecated. I found that by reading the original issue (#10909) about documenting the convention. That issue also reminded me that the old (pre Go 1.0) blog post about doc comments had been updated to explain deprecation notices. That blog post now starts with a note directing readers to the new "Go Doc Comments" document, which might dissuade them from reading the rest of the blog post and missing the info about deprecation notices.
It seems to me that we should add a section about deprecation notices to the Go Doc Comments document.
The text was updated successfully, but these errors were encountered: