Live data from Hacker News

Ask HN: What's the best documentation you've ever read?

news.ycombinator.com

51–60 of 79 posts

Re: Ask HN: What's the best documentation you've ever read?

#51

MDN because it's exhaustive https://developer.mozilla.org/en-US/ Jekyll because it's beautiful and the user can read all the pages at once with the previous/next buttons (at the bottom) https://jekyllrb.com/docs/home/ Node.js because they propose a single page version and it makes search easier https://nodejs.org/dist/latest-v10.x/docs/api/all.html

MDN is spectacular.

Re: Ask HN: What's the best documentation you've ever read?

#53
post #27

Go

Really? I thought they were horrible. I gave up on learning the language mainly because of the documentation.

Wow. We had totally different experience with it then. To me it has always been simple and straight forward. Also the go tour was great to get started with the language.

Re: Ask HN: What's the best documentation you've ever read?

#56
post #13

Any discussion on documentation is incomplete without mentioning Django https://docs.djangoproject.com/en/2.0/

Came here to say this. The thing I love about Django’s documentation is the layering. From beginner tutorial through to high level overviews of the subsystems, through to detailed usage for the subsystems, through to API level docs, through to the source code - all of it is there, and all linked together well. On top of that, it’s all well written, approachable, full of notes and caveats/warnings where necessary (for…

I sat down to learn Django many years ago and felt the same way:

While the learning curve seemed to go on and on, the documentation had a half-tutorial, half-specification answer for everything.

Post reply on HN