News for hackers. Stuff that matters.
Re:Teach, Don't Tell (2013) by jeffreygoesto on Monday March 17, 2025 @03:23AM (#43385964)
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.

Re:Teach, Don't Tell (2013) by ChrisMarshallNY on Monday March 17, 2025 @05:04AM (#43386459)
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.

Re:Teach, Don't Tell (2013) by mevric on Monday March 17, 2025 @10:39AM (#43389077)
+1 for recipes I have provided recipes in my documentation for complex projects, making it a time-saver for both me and my audience.