News for hackers. Stuff that matters.
Re:Ask HN: Which programming language has the best documenta... by spacemanaki on Wednesday August 10, 2011 @09:12PM (#2870918)
The Java standard library docs are very good, and the language spec is quite clear and precisely defined.

Another language with brutally specific docs is Common Lisp. Even though I have really only dabbled in it, the Hyperspec is really pretty impressive.

At least one common factor between them is Guy Steele, I don't think that's a coincidence.

Edited to add that I'm pretty sure my comment was motivated by this comment by mahmud: http://news.ycombinator.com/item?id=1661254

Re:Ask HN: Which programming language has the best documenta... by colanderman on Wednesday August 10, 2011 @11:29PM (#2871226)
I remember reading that Guy Steele was specifically hired to the Java project for this reason. Wikipedia corroborates this: "In 1994, Steele joined Sun Microsystems and was invited by Bill Joy to become a member of the Java team after the language had been designed, since he had a track record of writing good specifications for existing languages."

He also documented ECMAScript 1, which I've found to be pleasurably precise.

Re:Ask HN: Which programming language has the best documenta... by brudgers on Wednesday August 10, 2011 @10:19PM (#2871063)
It depends on how narrowly one defines "documentation" and what one means by "best."

I.e. there's probably a book on Visual Basic that's a good fit for just about anyone's level of interest and programming experience...assuming of course that one has an interest in Visual Basic.

On the other hand, K&R is a concise and well written.

Yet one has an inexhaustible supply of JavaScript examples only an F12 away.

Re:Ask HN: Which programming language has the best documenta... by zoowar on Wednesday August 10, 2011 @10:29PM (#2871085)
When you answer, you get to define the scope.
Re:Ask HN: Which programming language has the best documenta... by zoowar on Wednesday August 10, 2011 @09:22PM (#2870941)
In addition to documentation, I find a language specification useful. Golang has an excellent one http://golang.org/doc/go_spec.html My original Stroustrup C++book included a language specification which was nice.
Re:Ask HN: Which programming language has the best documenta... by zoowar on Wednesday August 10, 2011 @08:53PM (#2870882)
Re:Ask HN: Which programming language has the best documenta... by harold on Wednesday August 10, 2011 @09:45PM (#2870990)
also the PEPs for Python: http://www.python.org/dev/peps/
Re:Ask HN: Which programming language has the best documenta... by colanderman on Wednesday August 10, 2011 @11:33PM (#2871233)
I'm going to vote twice:

1) ECMAScript, for being excrutiatingly detailed. Guy Steele did a wonderful job shoehorning an unambiguous specification around a loopy language. 2) PostgreSQL. While not particularly mathematical, Postgres docs do a good job of "covering all the bases"... potential "gotchas" and incompatibilities are always documented, and I never find myself wondering what a particular feature does.

Re:Ask HN: Which programming language has the best documenta... by samth on Thursday August 11, 2011 @10:15AM (#2872925)
The Racket Guide [1] and Reference [2] are very nice (and almost all the work of just one person, Matthew Flatt).

[1] http://docs.racket-lang.org/guide/ [2] http://docs.racket-lang.org/reference/

Re:Ask HN: Which programming language has the best documenta... by VicT11 on Thursday August 11, 2011 @04:22AM (#2871975)
In my experience I've been trying to learn beginner programming with Ruby on Rails. I feel like there are tons of high quality resources for Python that I come across. Ruby on rails documentation seems pretty good. Ruby documentation though has been tough to find.
Re:Ask HN: Which programming language has the best documenta... by mikeburrelljr on Thursday August 11, 2011 @01:40AM (#2871579)
Re:Ask HN: Which programming language has the best documenta... by TMK on Wednesday August 10, 2011 @09:07PM (#2870913)
C ISO/IEC 9899 - 1999 Standard is my favourite piece of documentation.