Category:Tutorial - Revision history

Klinger: /* Comparison to other resource page types */

2024-04-18T20:34:22Z

Comparison to other resource page types

← Older revision		Revision as of 20:34, 18 April 2024
Line 25:		Line 25:
	* 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 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 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 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]].		* If a page is a detailed reference (like a man page or full software manual), it would fit under [[:Category:reference\|references]].

	[[Category:Resource]]		[[Category:Resource]]

Klinger: separated the beginning with explanation what a tutorial is from the tutorial to write a tutorial with a heading

2024-04-18T20:28:08Z

separated the beginning with explanation what a tutorial is from the tutorial to write a tutorial with a heading

← Older revision		Revision as of 20:28, 18 April 2024
Line 4:		Line 4:

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

imported>Nix: make Tutorial a subcategory of "Resource"

2021-09-20T09:08:35Z

make Tutorial a subcategory of "Resource"

← Older revision		Revision as of 09:08, 20 September 2021
Line 25:		Line 25:
	* 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 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]].		* If a page is a detailed reference (like a man page or full software manual), it would fit under [[:Category:reference\|references]].

			[[Category:Resource]]

imported>Nix: add full resource type comparison

2021-09-20T01:17:37Z

add full resource type comparison

← Older revision		Revision as of 01:17, 20 September 2021
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.

Line 17:		Line 19:
	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.

	~~The difference~~ to ~~the~~ [[:Category:~~Cookbook~~\|~~Cookbook~~]] is ~~that with~~ a tutorial ~~you cannot assume previous knowledge about the subject and the steps should always~~ be ~~reproducible~~.		=== 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 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]].

imported>Makefu at 14:37, 25 November 2017

2017-11-25T14:37:06Z

← Older revision		Revision as of 14:37, 25 November 2017
Line 17:		Line 17:
	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.

	The difference to the [[Category:Cookbook\|Cookbook]] is that with a tutorial you cannot assume previous knowledge about the subject and the steps should always be reproducible.		The difference to the [[:Category:Cookbook\|Cookbook]] is that with a tutorial you cannot assume previous knowledge about the subject and the steps should always be reproducible.

imported>Makefu at 14:35, 25 November 2017

2017-11-25T14:35:24Z

← Older revision		Revision as of 14:35, 25 November 2017
Line 17:		Line 17:
	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.

	The difference to the [[Category:Cookbook]] is that with a tutorial you cannot assume previous knowledge about the subject and the steps should always be reproducible.		The difference to the [[Category:Cookbook\|Cookbook]] is that with a tutorial you cannot assume previous knowledge about the subject and the steps should always be reproducible.

imported>Makefu at 14:34, 25 November 2017

2017-11-25T14:34:28Z

← Older revision		Revision as of 14:34, 25 November 2017
Line 16:		Line 16:

	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.

			The difference to the [[Category:Cookbook]] is that with a tutorial you cannot assume previous knowledge about the subject and the steps should always be reproducible.

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

2017-08-23T11:49:06Z

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

New page

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.

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

The end and the actions are up to you, but deciding what they should be can be hard work. The end has to be meaningful, but also achievable for a complete beginner.

''Consider an analogy of teaching a child to cook.''

What you teach the child to cook isn’t really important. What’s important is that the child finds it enjoyable, and gains confidence, and wants to do it again.

Through the things the child does, it will learn important things about cooking. It will learn what it is like to be in the kitchen, to use the utensils, to handle the food.

This is because '''using software, like cooking, is a matter of craft'''. It’s knowledge - but it is practical knowledge, not theoretical knowledge. When we learn a new craft or skill, we always begin learning it by doing.

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.

← Older revision		Revision as of 20:34, 18 April 2024
Line 25:		Line 25:
	* 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 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 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 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]].		* If a page is a detailed reference (like a man page or full software manual), it would fit under [[:Category:reference\|references]].

	[[Category:Resource]]		[[Category:Resource]]