Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

My tooling does this too and I don't even need to remember a terminal command: http://i.imgur.com/YmAkBPG.png

I get what your saying but it's apples to oranges. They are in effect similar though.



I (and I guess many others) enjoy that Golang's documentation strategy is coupled far tighter to the language (almost as a component of the language), in contrast to JavaDoc's existence as more of a standard for writing comments, `javadoc` being the first of many implementations and variations on it.

I'm not saying this is in any way empirically superior, in fact I think Go's approach owes a lot to Sun's original vision with JavaDoc. Some just prefer it and feel it's approach benefits them, and it's a preference that is often factored in when making the choice to use it.

My original point was that Sun's approach is now so commonplace it's an 'apples and oranges' argument. Golang has made a legitimate step forward (I think), in how a language treats and encourages it's documentation: As a first class citizen from day 0, rather than a convenient afterthought. The parity of experience between godoc.org & `go doc` demonstrates this with ample effect.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: