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:
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
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/