Differences Between How-To and Tutorial Documentation - Open Documentation Hour
Ubuntu OnAir via YouTube
Overview
Syllabus
Intro
Updates
Presentation starts
How-to vs. a tutorial
Cooking example
Similarities between the two
Differences between working and learning
More confusion
Further reading
Diátaxis definitions
Questions
When do you need a tutorial?
How do you decide if you need one or the other?
How simple should a How-to be
Other options on how the two differ
Tutorials that glue the product together
Tutorials for teaching, How-tos for general use
How do you know if your tutorial is effective?
What'a a good advanced-level tutorial?
Should you use screenshots?
Where is the single source of truth?
Taught by
Ubuntu OnAir