> ...where I'm still left wondering "what's the difference between a tutorial and a how-to guide?"
replyI don't find this question difficult. Without looking anything up, a tutorial exercises a contrived example for learning purposes, whereas a how-to guide provides instructions suitable for real world execution.
Ah ok, thanks for clarifying contrived vs real. Like a videogame tutorial I suppose.
replyHow to guide is for things which you want to do, probably not without going in depth or understanding the technicalities.
replyExample in our codebase
- How to clear the cache ?
- How to configure the logger ?
I liked the idea of separating our how to guides and explanations / tutorials, because sometimes you just want engineers to follow a specific flow without going too much in depth.