Category:Tutorial: Difference between revisions

(One intermediate revision by the same user not shown)

Line 4:

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'''.

Line 19:

Line 21:

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 ===

== 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]]

@@ Line 4: / Line 4: @@
 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'''.
@@ Line 19: / Line 21: @@
 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 ===
+== 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]]