Hacker News new | past | comments | ask | show | jobs | submit login

What is the difference between "Tutorials" and "How to guides"?



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.





Consider applying for YC's Summer 2025 batch! Applications are open till May 13

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: