Hacker News new | ask | show | jobs
by rgun 452 days ago
What is the difference between "Tutorials" and "How to guides"?
2 comments

It is explained well in the video, well worth watching.

Tutorials are teaching a method, like which ends of the pliers you grab. They do not assume a lot of domain knowledge.

HowTos pick the user up where she stands with a concrete problem and walks you through a possible solution of that specific problem. Like how to use pliers to twist a wire just firmly enough to hold two things together.

Often referred to, as “recipes.” —Defining the goal, and a specific set of steps, to achieve that singular outcome.

How to calculate the airspeed velocity of an unladen swallow, etc.

+1 for recipes I have provided recipes in my documentation for complex projects, making it a time-saver for both me and my audience.