GMU:Tutorials/Documentation/Tutorial How-To - Revision history

TVischer at 18:23, 30 July 2016

2016-07-30T18:23:01Z

← Older revision		Revision as of 18:23, 30 July 2016
Line 1:		Line 1:
	~~'''~~How to write an online Tutorial~~'''~~		==How to write an online Tutorial==

	Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as it should be. So in this tutorial i want to explain what you can do to make it better.		Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as it should be. So in this tutorial i want to explain what you can do to make it better.
Line 7:		Line 7:
	You should write about anything, but it helps if you're feeling passionate about you're project. You should also preferably wrote about something original, there are not that many projects online here but you should first check if no one else wrote about it yet.		You should write about anything, but it helps if you're feeling passionate about you're project. You should also preferably wrote about something original, there are not that many projects online here but you should first check if no one else wrote about it yet.

	~~'''~~You should use the Wiki to…~~'''~~		==You should use the Wiki to…==

	Show us what you have made		Show us what you have made
Line 52:		Line 52:
	==Structure==		==Structure==

	Title		===Title===
	You need to be aware of the way your reader encounters your work.		You need to be aware of the way your reader encounters your work.
	The first thing the reader sees is unfortunately just the title of the work and the description of the course it was made in.		The first thing the reader sees is unfortunately just the title of the work and the description of the course it was made in.
Line 68:		Line 68:


	Top Picture		===Top Picture===
	For the Top of your page choose a picture that shows your work in its best light. This is the first time the reader is going to encounter your work by actually seeing it, so it has to make a good impression.		For the Top of your page choose a picture that shows your work in its best light. This is the first time the reader is going to encounter your work by actually seeing it, so it has to make a good impression.

	Instruction		===Instruction===
	Position an instruction underneath the top image. The instruction itself should be reasonably short, and doesn't need to include any details of how you made the project. Throw in a little history of how you came up with the project if you like. If the back-story is long, it might be worth a whole step to itself.		Position an instruction underneath the top image. The instruction itself should be reasonably short, and doesn't need to include any details of how you made the project. Throw in a little history of how you came up with the project if you like. If the back-story is long, it might be worth a whole step to itself.
	Assuming the title and course description has persuaded the reader to start reading the next thing they see is a photo of your work and the instruction. This is the last chance to convince wavering readers to continue reading, so take a few minutes to get it right		Assuming the title and course description has persuaded the reader to start reading the next thing they see is a photo of your work and the instruction. This is the last chance to convince wavering readers to continue reading, so take a few minutes to get it right

	The Other Steps		===The Other Steps===

	Theres no rule how you want to structure your tutorial every tutorial/presentation differs from the other, but there are some essential steps you should keep in mind:		Theres no rule how you want to structure your tutorial every tutorial/presentation differs from the other, but there are some essential steps you should keep in mind:

	Materials and Tools		===Materials and Tools===
	Make a list to help others to get organised before rebuilding you're project in real or in they're minds especially if there are special uncommon items they need to borrow or buy.		Make a list to help others to get organised before rebuilding you're project in real or in they're minds especially if there are special uncommon items they need to borrow or buy.

	Preparation		===Preparation===

	For projects that have to do with electronics for example do you need to prepare something? Anti static mat, preheating your soldering iron, 3D printing some parts etc.		For projects that have to do with electronics for example do you need to prepare something? Anti static mat, preheating your soldering iron, 3D printing some parts etc.

	How you made it		===How you made it===

	Make a step by step description of how you made and better take it slow. No one knows better what you've did than you yourself but for others it maybe isn't that easy to follow your lead.		Make a step by step description of how you made and better take it slow. No one knows better what you've did than you yourself but for others it maybe isn't that easy to follow your lead.

	Tips		===Tips===
	Have you been confronted with some issues that were hard to figure out how to do but you solved it somehow using a clever trick. Then share it with you're readers they will be thankful about that.		Have you been confronted with some issues that were hard to figure out how to do but you solved it somehow using a clever trick. Then share it with you're readers they will be thankful about that.

	Further Ideas		===Further Ideas===
	Now after finishing your projecting and reflecting onto it while writing about it. Do you have plans for the future, do you think theres more potential in it or do you want to do something different than you did. You'll readers will be excited to hear about it especially if you've done some really vague project wich doesn't have an clear outline yet.		Now after finishing your projecting and reflecting onto it while writing about it. Do you have plans for the future, do you think theres more potential in it or do you want to do something different than you did. You'll readers will be excited to hear about it especially if you've done some really vague project wich doesn't have an clear outline yet.

	Layout		===Layout===

	There are some things you should mind using the wiki, it has some shortcuts for lay outing the text that you need to quote into you're text.		There are some things you should mind using the wiki, it has some shortcuts for lay outing the text that you need to quote into you're text.
	Also theres a sidebar above the text window wich contains shortcuts for lay outing:		Also theres a sidebar above the text window wich contains shortcuts for lay outing:
Line 136:		Line 132:

	2. Compress your image as much as you can (the wiki wont show to big files either)		2. Compress your image as much as you can (the wiki wont show to big files either)

			'''Here are some other Wiki commands that will help you formatting your Text:'''

			[[File:Screen_Shot_2016-07-30_at_20.02.56.png]]
			[[File:Screen_Shot_2016-07-30_at_20.03.11.png]]
			[[File:Screen_Shot_2016-07-30_at_20.03.26.png]]
			[[File:Screen_Shot_2016-07-30_at_20.03.41.png]]
			[[File:Screen_Shot_2016-07-30_at_20.04.06.png]]
			[[File:Screen_Shot_2016-07-30_at_20.04.45.png]]
			[[File:Screen_Shot_2016-07-30_at_20.04.56.png]]

TVischer at 16:58, 1 July 2016

2016-07-01T16:58:22Z

← Older revision		Revision as of 16:58, 1 July 2016
Line 1:		Line 1:
	How to write an online Tutorial		'''How to write an online Tutorial'''

	Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as it should be. So in this tutorial i want to explain what you can do to make it better.		Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as it should be. So in this tutorial i want to explain what you can do to make it better.

TVischer at 16:56, 1 July 2016

2016-07-01T16:56:14Z

← Older revision		Revision as of 16:56, 1 July 2016
Line 1:		Line 1:
	How to write an online Tutorial		How to write an online Tutorial

	Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as ~~they~~ should be. So in this tutorial i want to explain what you can do to make it better.		Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as it should be. So in this tutorial i want to explain what you can do to make it better.

	==Subject Matter==		==Subject Matter==

	You should write about anything, but it helps if you're feeling passionate about you're project. You should also preferably wrote about something original, there are not that many projects online here but you should first check if no one else ~~write~~ about it yet.		You should write about anything, but it helps if you're feeling passionate about you're project. You should also preferably wrote about something original, there are not that many projects online here but you should first check if no one else wrote about it yet.

	'''You should use the Wiki to…'''		'''You should use the Wiki to…'''
Line 19:		Line 19:
	Show us somebody else work		Show us somebody else work

	Try and sell something without basic understanding how you accomplished it		Try and sell us something, without basic understanding of how you accomplished it

	Write inappropriate things		Write inappropriate things

	You should preferably write in english if not otherwise stated in your course description, so that every foreign student has a chance to understand the things that you've made. Also you should watch your language, you don't need to write a scientific masterpiece of a research but you're Professor will still ~~probably~~ read it.		You should preferably write in english if not otherwise stated in your course description, so that every foreign student has a chance to understand the things that you've made. Also you should watch your language, you don't need to write a scientific masterpiece of a research but you're Professor will still read it.

	==What kind of Tutorial should i do==		==What kind of Tutorial should i do==
Line 51:		Line 51:

	==Structure==		==Structure==

	Title		Title
	You need to be aware of the way your reader encounters your work.		You need to be aware of the way your reader encounters your work.

TVischer at 16:53, 1 July 2016

2016-07-01T16:53:31Z

← Older revision		Revision as of 16:53, 1 July 2016
Line 1:		Line 1:
	How to write an online ~~tutorial~~		How to write an online Tutorial

	Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as they should be. So in this tutorial i want to explain what you can do to make it better.		Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as they should be. So in this tutorial i want to explain what you can do to make it better.

TVischer at 16:50, 1 July 2016

2016-07-01T16:50:47Z

← Older revision		Revision as of 16:50, 1 July 2016
Line 7:		Line 7:
	You should write about anything, but it helps if you're feeling passionate about you're project. You should also preferably wrote about something original, there are not that many projects online here but you should first check if no one else write about it yet.		You should write about anything, but it helps if you're feeling passionate about you're project. You should also preferably wrote about something original, there are not that many projects online here but you should first check if no one else write about it yet.

	You should use the Wiki to…		'''You should use the Wiki to…'''

	Show us what you have made		Show us what you have made
Line 15:		Line 15:
	Show us how to do something		Show us how to do something

	You shouldn't use it for…		'''You shouldn't use it for…'''

	Show us somebody else work		Show us somebody else work
Line 143:		Line 143:

	'''Screenshot''' pressing''' ctrl+ shift+ alt + s''' (wich will be saved in the images folder)		'''Screenshot''' pressing''' ctrl+ shift+ alt + s''' (wich will be saved in the images folder)
	'''
	Screen recording''' pressing '''alt+ cmd+ v''' (you can start and stop with this command. There is a red dot appearing in the Top bar of the Dektop to indicate that youre currently recording. The video will be saved in your video folder)		'''Screen recording''' pressing '''alt+ cmd+ v''' (you can start and stop with this command. There is a red dot appearing in the Top bar of the Dektop to indicate that youre currently recording. The video will be saved in your video folder)

TVischer at 16:48, 1 July 2016

2016-07-01T16:48:17Z

← Older revision		Revision as of 16:48, 1 July 2016
Line 142:		Line 142:
	The PC in the Performance lab is running Debian you can make a:		The PC in the Performance lab is running Debian you can make a:

	Screenshot ~~using~~''' ctrl+ shift+ alt + s''' (wich will be saved in the images folder)		'''Screenshot''' pressing''' ctrl+ shift+ alt + s''' (wich will be saved in the images folder)
			'''
	Screen recording '''alt+ cmd+ v''' (you can start and stop with this command. There is a red dot appearing in the Top bar of the Dektop to indicate that youre currently recording. The video will be saved in your video folder)		Screen recording''' pressing '''alt+ cmd+ v''' (you can start and stop with this command. There is a red dot appearing in the Top bar of the Dektop to indicate that youre currently recording. The video will be saved in your video folder)

TVischer at 16:47, 1 July 2016

2016-07-01T16:47:22Z

← Older revision		Revision as of 16:47, 1 July 2016
Line 1:		Line 1:
	How to write an online tutorial		How to write an online tutorial

	Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as ~~you could reimagine them~~. So in this tutorial i want to explain ~~how~~ you can do make it better.		Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as they should be. So in this tutorial i want to explain what you can do to make it better.

	==Subject Matter==		==Subject Matter==
Line 99:		Line 99:
	There are some things you should mind using the wiki, it has some shortcuts for lay outing the text that you need to quote into you're text.		There are some things you should mind using the wiki, it has some shortcuts for lay outing the text that you need to quote into you're text.
	Also theres a sidebar above the text window wich contains shortcuts for lay outing:		Also theres a sidebar above the text window wich contains shortcuts for lay outing:

			[[File:Screen_Shot_2016-07-01_at_18.16.09.png]]

	Writing bold		Writing bold

Line 124:		Line 127:

	You will find the option to upload images to the wiki on the left side underneath the Bold Headlines in the sidebar.		You will find the option to upload images to the wiki on the left side underneath the Bold Headlines in the sidebar.

			[[File:Screen_Shot_2016-07-01_at_18.44.20.png]]

	You can then choose a picture to upload from your PC but mind two things		You can then choose a picture to upload from your PC but mind two things

Line 136:		Line 142:
	The PC in the Performance lab is running Debian you can make a:		The PC in the Performance lab is running Debian you can make a:

	Screenshot using ctrl+ shift+ alt + s (wich will be saved in the images folder)		Screenshot using''' ctrl+ shift+ alt + s''' (wich will be saved in the images folder)

	Screen recording alt+ cmd+ v (you can start and stop with this command. There is a red dot appearing in the Top bar of the Dektop to indicate that youre currently recording. The video will be saved in your video folder)		Screen recording '''alt+ cmd+ v''' (you can start and stop with this command. There is a red dot appearing in the Top bar of the Dektop to indicate that youre currently recording. The video will be saved in your video folder)

TVischer: Created page with " How to write an online tutorial Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as you could reima..."

2016-07-01T16:42:58Z

Created page with " How to write an online tutorial Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as you could reima..."

New page

How to write an online tutorial

Tutorials are one main reason the Medienwiki exists, but not everything is as well documented as you could reimagine them. So in this tutorial i want to explain how you can do make it better.

==Subject Matter==

You should write about anything, but it helps if you're feeling passionate about you're project. You should also preferably wrote about something original, there are not that many projects online here but you should first check if no one else write about it yet.

You should use the Wiki to…

Show us what you have made

Show us how you made something

Show us how to do something

You shouldn't use it for…

Show us somebody else work

Try and sell something without basic understanding how you accomplished it

Write inappropriate things

You should preferably write in english if not otherwise stated in your course description, so that every foreign student has a chance to understand the things that you've made. Also you should watch your language, you don't need to write a scientific masterpiece of a research but you're Professor will still probably read it.

==What kind of Tutorial should i do==

Basically using the current version of the wiki only allows you to make a step by step instruction. You could also film what you're doing and setting up a link to the video into the wiki. (youll find a good guide for making a video tutorial [http://www.creativebloq.com/video-production/make-tutorial-video-2131915 here])
The step by step tutorial consists of one step followed by some photos at a time.
You could split it up like this:

Preparation

What you need for it

Start

Some small explanatory steps

End result with some photos or a video

==Photos==

For making a good online Tutorial its essential that you're taking good photographs.
You should always try to make your own photos and illustrations of your work, cause the wiki isn't meant to be hosting content from content that you found on the internet.
Use a proper scanner to digitalise drawings and schematics.
You should also think of using a proper camera for taking photos of your work rather than quickly taking a snapshot with your mobile phone, you will thank yourself later for having your work properly documented.
Make sure the image is sharp and the object is in focus use macro settings if you need to. Take photographs from different angles of your object and try to light your object even. You should use a white background for it and lots of daylight, if it isn't available try using a desk lamp. (you can also build you're own [http://www.instructables.com/id/Photography-Light-Box/ lightbox] )
Take more photos than you need, you can upload them into a gallery function.

==Structure==
Title
You need to be aware of the way your reader encounters your work.
The first thing the reader sees is unfortunately just the title of the work and the description of the course it was made in.
So you need to have a good catchy title that wakes up the readers interest.

Good title: How to make a ### to help you ###

Good title: Improve your ### by ### and ###.

Bad title: The Widget by Name!

Bad title: What everyone has been waiting for: the AWESOME PROJECT!!!!!

Bad title: Yet Another ……

Top Picture
For the Top of your page choose a picture that shows your work in its best light. This is the first time the reader is going to encounter your work by actually seeing it, so it has to make a good impression.

Instruction
Position an instruction underneath the top image. The instruction itself should be reasonably short, and doesn't need to include any details of how you made the project. Throw in a little history of how you came up with the project if you like. If the back-story is long, it might be worth a whole step to itself.
Assuming the title and course description has persuaded the reader to start reading the next thing they see is a photo of your work and the instruction. This is the last chance to convince wavering readers to continue reading, so take a few minutes to get it right

The Other Steps

Theres no rule how you want to structure your tutorial every tutorial/presentation differs from the other, but there are some essential steps you should keep in mind:

Materials and Tools
Make a list to help others to get organised before rebuilding you're project in real or in they're minds especially if there are special uncommon items they need to borrow or buy.

Preparation

For projects that have to do with electronics for example do you need to prepare something? Anti static mat, preheating your soldering iron, 3D printing some parts etc.

How you made it

Make a step by step description of how you made and better take it slow. No one knows better what you've did than you yourself but for others it maybe isn't that easy to follow your lead.

Tips
Have you been confronted with some issues that were hard to figure out how to do but you solved it somehow using a clever trick. Then share it with you're readers they will be thankful about that.

Further Ideas
Now after finishing your projecting and reflecting onto it while writing about it. Do you have plans for the future, do you think theres more potential in it or do you want to do something different than you did. You'll readers will be excited to hear about it especially if you've done some really vague project wich doesn't have an clear outline yet.

Layout

There are some things you should mind using the wiki, it has some shortcuts for lay outing the text that you need to quote into you're text.
Also theres a sidebar above the text window wich contains shortcuts for lay outing:
Writing bold

Writing cursive

Writing underlined

Linking a Website

Writing an Headline Text

Implementing an Image

Linking a file

Writing an formula

Ignore the wiki specific preset lay outing rules

Add a signature and a timestamp

Adding a line

You will find the option to upload images to the wiki on the left side underneath the Bold Headlines in the sidebar.
You can then choose a picture to upload from your PC but mind two things

1. Upload a .png file (.jpg files cant be uploaded to the wiki)

2. Compress your image as much as you can (the wiki wont show to big files either)

==Performance Platform specific==

The PC in the Performance lab is running Debian you can make a:

Screenshot using ctrl+ shift+ alt + s (wich will be saved in the images folder)

Screen recording alt+ cmd+ v (you can start and stop with this command. There is a red dot appearing in the Top bar of the Dektop to indicate that youre currently recording. The video will be saved in your video folder)