Proposal: write a Go Type Parameters Reference document

151 views
Skip to first unread message

Manlio Perillo

unread,
Jan 27, 2022, 4:45:43 AM1/27/22
to golang-nuts
Go generics are complex.
Currently the only useful documentation (excluding the Go Language Specification) is the original design:  golang.org/design/43651-type-parameters.

I propose to fork the design document to create a new document
"Go Type Parameters Reference" and publish it in https://go.dev/ref/generics.

The new document should be a copy of the original design, with some sections removed , a new section with code not working with go1.18 but that may work in future and a new section with a glossary.  Some examples still don't work with go1.18 and should be fixed.

Thanks
Manlio

Ian Lance Taylor

unread,
Jan 27, 2022, 4:14:20 PM1/27/22
to Manlio Perillo, golang-nuts
Thanks, but I think that our goal should be that the reference for the
language is the language spec (https://go.dev/ref/spec). Adding more
information about generics is in progress.

The proposal design can remain as a longer-term view of where we hope
that generics will get to in future releases.

Ian
Reply all
Reply to author
Forward
0 new messages