The Programmers Before Us Were Better

Re:The Programmers Before Us Were Better by eckyptang on Friday September 28, 2012 @05:23AM (#4584792)

This times a million. Microsoft, OpenBSD and Golang are the only things I've found that produce good quality extensive reference documentation these days that I can take offline.

Python documentation, while extensive, is crappy.

I still miss my Sun Ultra enterprise 2. That was documented to bits.

[ Parent | on HN ]

Re:The Programmers Before Us Were Better by josephlord on Friday September 28, 2012 @06:49AM (#4584931)

To add to your list I like the PostgreSQL manuals. They always seem detailed and clear.

I find the Rails documentation awful lacking a lot of detail with an expectation that you read the source which in places is fairly hard to follow through several layers and even if you find the relevant part without good documentation you can't tell if it is a bug or intended behaviour in some cases.

[ Parent | on HN ]

Re:The Programmers Before Us Were Better by eckyptang on Friday September 28, 2012 @07:03AM (#4584961)

Yes I probably should have added postgres. I like the fact that they keep the documentation nicely versioned as well. The quality is fantastic too.

[ Parent | on HN ]

Re:The Programmers Before Us Were Better by srl on Friday September 28, 2012 @08:35AM (#4585166)

I'd add FreeBSD to that list. Back when I was setting up linux on my macbook, I first went to the FreeBSD manuals to learn how things worked.

[ Parent | on HN ]