News for hackers. Stuff that matters.

Ask HN: What's the best documentation you've ever read (or written)?

I've been thinking a lot about documentation and how to get a user up to speed on a code base as quickly and effortlessly (on the part of the user) as possible.

I know "best" can be somewhat arbitrary or subjective, but use whichever metric you think is most relevant (organization, clarity, etc...). And, if you'd like, let me know what you think "best" should mean in relation to documentation quality.

Also, I know this question has been asked before, but those threads are all several years old, so in that time the documentation pool has obviously changed (and hopefully improved).

( 5 comments | 6 points | on HN )
Re:Ask HN: What's the best documentation you've ever read (o... by bitshepherd on Saturday February 06, 2016 @02:06PM (#11049189)
https://freebsd.org/handbook

It's a comprehensive, yet not too dense, set of documentation for getting people up to speed on how to do things with FreeBSD. You may not find a better one even today.

Re:Ask HN: What's the best documentation you've ever read (o... by zbjornson on Saturday February 06, 2016 @10:50PM (#11051505)
The reference pages for Mathematica are by far the best docs I've seen for a programming language. They're thorough and each example can be evaluated in place.

Online version here [1] is not evaluatable and is rendered to images, but otherwise it's the same content as the desktop version. Specific example [2].

[1] http://reference.wolfram.com/language/ [2] http://reference.wolfram.com/language/ref/Histogram.html

Re:Ask HN: What's the best documentation you've ever read (o... by codegeek on Saturday February 06, 2016 @03:33PM (#11049686)
I like the official git documentation. There are many tutorials out there but reading through the official doc always makes things clearer to me at least

https://git-scm.com/doc

I also like Stripe documentation

https://stripe.com/docs

Re:Ask HN: What's the best documentation you've ever read (o... by drakenot on Saturday February 06, 2016 @10:02PM (#11051361)
ZeroMQ Guide has frequently been mentioned on HN as one of the better pieces of software documentation:

http://zguide.zeromq.org/

It is useful not just for using ZeroMQ, but about learning about distributed systems in general.

Re:Ask HN: What's the best documentation you've ever read (o... by apoorv_arora on Saturday February 06, 2016 @02:48PM (#11049426)
https://www.digifire.in/2016/02/06/interview-with-apoorv-aro...

It's a recently written tech interview for a startup named Baatna. Good read!