2 ms·
I looked at those links. Here's what I got from them: 1. Tutorials "are lessons that take the reader by the hand through a series of steps." They "are orient
by useragent86 6y ago
I looked at those links. Here's what I got from them:
1. Tutorials "are lessons that take the reader by the hand through a series of steps." They "are oriented towards learning how."
2. How-to guides "take the reader through steps."
3. "How-to guides are wholly distinct from tutorials."
If I found a "community" around a topic, do I then get to decide what words mean? By consensus, of course.
- xixixao 6y agoYou can see a good breakdown of what they mean by each label in this table: https://documentation.divio.com/introduction/#the-secret https://documentation.divio.com/introduction/#the-secret It's certainly a valuable take, even if you disagree with the claim that all 4 functions are required for good documentation.
- quietbritishjim 6y agoWhat specifically are you referring to in that table? The original article is a lesson on how to use JavaScript, from scratch, for a beginner. That perfectly fulfills all four requirements in the "tutorial" column: > oriented to: learning > must: allow the newcomer to get started > its form: a lesson > analogy: teaching a small child how to cook It does not satify all the requirements of any other column.