Starting next year, I am planning to write more well-organized tutorials as a way to increase my rate of learning and understanding (The topics won't be of interest to general HN community). But I wanted the see what kind of best practices are appreciated in the community. I am not referring to documentation per se, of which I do plenty for myself during work. But on improving myself as a communicator in the written medium when explaining things through code+simpler language.
Ask HN: Which are the best written tutorials you have seen till now?
1–10 of 25 posts
Re: Ask HN: Which are the best written tutorials you have seen till now?
#2Any of the Explorable Explanations that Bret Victor creates. Later followed up by more from Nicky Case, and more
Re: Ask HN: Which are the best written tutorials you have seen till now?
#3I really like Mark Myers' style. He writes "A Smarter Way to Learn Bla" books. His books allow you to turn off your brain and simply sail through.
Re: Ask HN: Which are the best written tutorials you have seen till now?
#4I really like Mark Myers' style. He writes "A Smarter Way to Learn Bla" books. His books allow you to turn off your brain and simply sail through.
Thank you. Could you link to some of his online pieces you like?
Re: Ask HN: Which are the best written tutorials you have seen till now?
#5Any of the Explorable Explanations that Bret Victor creates. Later followed up by more from Nicky Case, and more
All the links I clicked led to other websites. Is it an aggregator?
Re: Ask HN: Which are the best written tutorials you have seen till now?
#6This was probably the most effective tutorial I have ever used: https://www.amazon.com/RPG-III-400-Shelly-Cashman/dp/0878352...
Early in my consulting career, I got a gig doing RPG III and in three days got up to speed.
Not relevant to many folks these days.
Re: Ask HN: Which are the best written tutorials you have seen till now?
#7This was probably the most effective tutorial I have ever used: https://www.amazon.com/RPG-III-400-Shelly-Cashman/dp/0878352... Early in my consulting career, I got a gig doing RPG III and in three days got up to speed. Not relevant to many folks these days.
I'm more interested in exposition style, rather than topics. Is there anything particular you liked about that book? I'll try to find a PDF for a looksie.
Re: Ask HN: Which are the best written tutorials you have seen till now?
#8Any of the Explorable Explanations that Bret Victor creates. Later followed up by more from Nicky Case, and more
All the links I clicked led to other websites. Is it an aggregator?
What you saw probably was the collection created by Nicky Case. Check his own explanations though https://ncase.me/ and then also check http://worrydream.com/#!/ExplorableExplanations (and other explanations by Bret Victor)
Re: Ask HN: Which are the best written tutorials you have seen till now?
#9I'm sure it's a cliche at this point, but I don't think enough writers emulate K&R's style on The C Programming Language. The prose is short, dense, and yet not tedious.
Another great "tutorial" to emulate is the TeXbook by Knuth. This one is verbose, but it shows the reader all the little details and pitfalls about the software without becoming boring.
Re: Ask HN: Which are the best written tutorials you have seen till now?
#10Almost anything on NSHipster