Category:Tutorial: Difference between revisions
imported>Makefu Created page with "Tutorials are lessons that take the reader by the hand through a series of steps to complete a project of some kind. They are what your project needs in order to show a beginn..." |
|||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
''Tutorial'' is one of the five primary [[Resources|resource]] categories for the wiki. | |||
Tutorials are lessons that take the reader by the hand through a series of steps to complete a project of some kind. They are what your project needs in order to show a beginner that they can achieve something with it. | Tutorials are lessons that take the reader by the hand through a series of steps to complete a project of some kind. They are what your project needs in order to show a beginner that they can achieve something with it. | ||
They are wholly '''learning-oriented''', and specifically, they are oriented towards learning how rather than learning that. | They are wholly '''learning-oriented''', and specifically, they are oriented towards learning how rather than learning that. | ||
== Writing a tutorial == | |||
'''You are the teacher''', and you are '''responsible''' for what the student will do. Under '''your''' instruction, the student will execute a series of actions to achieve some '''end'''. | '''You are the teacher''', and you are '''responsible''' for what the student will do. Under '''your''' instruction, the student will execute a series of actions to achieve some '''end'''. | ||
| Line 16: | Line 20: | ||
The important thing is that having done the tutorial, the learner is in a position to make sense of the rest of the documentation, and the software itself. | The important thing is that having done the tutorial, the learner is in a position to make sense of the rest of the documentation, and the software itself. | ||
== Comparison to other resource page types == | |||
* If information is more encyclopedic (with a similar scope and tone to pages on [https://www.wikipedia.org/ Wikipedia]), a page would be considered a [[:Category:Pedias|pedia]]. | |||
* If information is less encyclopedic and more similar to a [https://en.wikipedia.org/wiki/Compendium compendium], [https://en.wikipedia.org/wiki/Study_guide study guide], or a [https://en.wikipedia.org/wiki/Guide_to_information_sources bibliographic guide], a page would be considered a [[:Category:Guide|guide]]. | |||
* If information is more about direct instruction to achieve a specific task, a page would be considered a [[:Category:Tutorial|tutorial]]. | |||
* If a page is more just a set of tips and tricks (less instructive than a tutorial), it would be a [[:Category:Cookbook|cookbook]]. | |||
* If a page is a detailed reference (like a man page or full software manual), it would fit under [[:Category:reference|references]]. | |||
[[Category:Resource]] | |||