News for hackers. Stuff that matters.
Re:Why Go Is An Excellent Modern Programming Language by thirsteh on Sunday July 28, 2013 @04:05PM (#6117893)
There are many examples in the Go docs, e.g. http://golang.org/pkg/net/http/#pkg-examples (runnable and editable too!) But I agree that there aren't enough, and that's probably the worst thing about Go documentation, especially when dealing with the lower-level libraries.

Just to be clear, I don't think verbosity means that documentation is better. Documentation is better when it gives you the information you need, and nothing more. That being said, I mostly think Go's documentation is better than Java's, and on par if not slightly better than C#'s. Here's a better example of what I mean, e.g. http://docs.oracle.com/javase/6/docs/api/allclasses-noframe.... vs. http://golang.org/pkg/

Granted, if you have no experience at all with the language--e.g. you haven't even taken the tour at http://tour.golang.org/--the documentation may be hard to read (what does "[]" mean, for example), but that's not the fault of API documentation, which rightly is clear and concise. Rather, that's the job for a comprehensive tutorial, which Go has: http://tour.golang.org/

Re:Why Go Is An Excellent Modern Programming Language by acqq on Sunday July 28, 2013 @04:18PM (#6117936)
Is this a joke about many examples? The example you link to at the current moment looks like this in two different browsers:

http://i40.tinypic.com/5vorps.png

Re:Why Go Is An Excellent Modern Programming Language by thirsteh on Sunday July 28, 2013 @04:26PM (#6117968)
I changed that a couple of minutes after posting. I just messed up the link.
Re:Why Go Is An Excellent Modern Programming Language by acqq on Sunday July 28, 2013 @05:48PM (#6118211)
I see you now link to completely another example. But the example of the listener you linked first, that is, at the time I've made a comment still just contains

http://golang.org/pkg/net/#example_Listener

   ---- begin example ---
   package main
   ---- end example ---
which is a good example of a nonexistence of one good example.
Re:Why Go Is An Excellent Modern Programming Language by thirsteh on Sunday July 28, 2013 @06:19PM (#6118324)
Like I said, I changed the link two minutes after I posted the comment (way before you posted yours, but whatever) because I messed up the link. You can find the listener example here: http://golang.org/pkg/net/#pkg-examples
Re:Why Go Is An Excellent Modern Programming Language by _random_ on Sunday July 28, 2013 @04:22PM (#6117955)
Dude, you are ignorant about the level of C# documentation.
Re:Why Go Is An Excellent Modern Programming Language by thirsteh on Sunday July 28, 2013 @04:26PM (#6117970)
Dude, I don't think I am.