I have that personal gripe about Go's documentation. Compared to C# and even PHP, Go's documentation is very short, often being a single line. For a beginner, i

I have that personal gripe about Go's documentation. Compared to C# and even PHP, Go's documentation is very short, often being a single line. For a beginner, it's difficult to learn Go this way.[1] Since taking it up, I've found it more helpful to buy books on Go, whereas I've been able to learn PHP and C# almost solely off the documentation. I still don't know much about Go and I feel Golang could do a much better job of documenting the language and making it accessible to beginners. http://golang.org/pkg/io/#WriteString http://golang.org/pkg/io/#WriteString vs http://php.net/fwrite http://php.net/fwrite and http://msdn.microsoft.com/en-us/library/ms143376.aspx http://msdn.microsoft.com/en-us/library/ms143376.aspx [1] Edit: I'm aware that learning via documentation is probably not the right way to do it, but it's part of the learning process and thus, good documentation is important.