search

golang / go

The Go programming language
https://go.dev
BSD 3-Clause "New" or "Revised" License
123.91k stars 17.65k forks source link

go/types: documentation needs to be updated #50676

Open griesemer opened 2 years ago

griesemer commented 2 years ago

The documentation on go/types needs to be updated for generics: https://github.com/golang/example/tree/master/gotypes

At the very least it should point out what's not yet documented with respect to generics.

cc: @findleyr

findleyr commented 2 years ago

The guide that I'm working on (starting with https://go-review.googlesource.com/c/tools/+/377834) is based on x/example/gotypes. I plan to both have the separate guide for 1.18, and integrate aspects of this into x/example/gotypes proper.

gopherbot commented 2 years ago

Change https://go.dev/cl/389656 mentions this issue: gotypes: add a link to the 1.18 API guide, and fix links

ianlancetaylor commented 2 years ago

Are we going to do something here for 1.19? Thanks.

findleyr commented 2 years ago

This documentation is in x/example; no need to associate with 1.19.

findleyr commented 2 years ago

At some point Alan and I should update x/example, but it is unfortunately not a high priority. Moving to the backlog.