4 ms·
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
by mattmanser 13y ago
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 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.
- thirsteh 13y agoThere are many examples in the Go docs, e.g. http://golang.org/pkg/net/http/#pkg-examples 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.html http://docs.oracle.com/javase/6/docs/api/allclasses-noframe.... vs. http://golang.org/pkg/ 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 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/ http://tour.golang.org/
- acqq 13y agoIs 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 http://i40.tinypic.com/5vorps.png
- thirsteh 13y agoI changed that a couple of minutes after posting. I just messed up the link.
- acqq 13y agoI 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 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.
- thirsteh 13y agoLike 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 http://golang.org/pkg/net/#pkg-examples
- _random_ 13y agoDude, you are ignorant about the level of C# documentation.
- thirsteh 13y agoDude, I don't think I am.