News for hackers. Stuff that matters.
Re:Why Go Is An Excellent Modern Programming Language by mattmanser on Sunday July 28, 2013 @03:57PM (#6117861)
In what crazy world is that documentation better than C#?

There are no examples, the lifeblood of documentation, nor any notes about gotchas?

It's early days in the language so that's not at all bad, but claiming the documentation is better when it's clearly not is odd.

http://msdn.microsoft.com/en-us/library/b9skfh7s.aspx

Also C# and java are going to have tons of examples on SO, so the amount of examples and extra documentation available is incomparable.

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.