PDA

View Full Version : [Major TuT] The Art Of Tutorialing



Aurion
20.07.08, 19:04
Well,hey guys !! How are ya ?? Hope you are doing just fine out there !! It came to my intention to post a Very Helpful TuT on How 2 write TuTs Professionally without asking or being asked to edit some titles or add extra info/tips to ur TuT,so the simple explanation goes as follows :

Introduction :

"Information is wealth", a famous dialogue from one of the Indian movies is so true when it comes to sharing information. It is wealth when one knows How to apply it? Where to apply it? and When to apply it? :biggrin:

Lot of us learn new things everyday and things which we learn may differ from one person to another. Things which I learn today, you might learn it tomorrow, next week, may be a month or even years later. Such information might be new and really useful for others who happened not to read or get to know just when you came across it. In such a case, being helpful, we tend to share our knowledge by some means and of late often by writing online tutorials. But WAIT! How do I go about doing it? Lot of us due to lack of knowledge of writing tutorials tend to curb our instincts of penning down our thoughts, rather nowadays we can say, "Typin' in our thots" :tongue:

Contents Of A Professional Rich Tutorial :

1. 1. What is it?
2. Things to do ?
3. Others stuff I might need ?

Lets Get Down to it :

1. What Is It ?

A. : As in related to technology, answers.com defines tutorial as "An instructional book or program that takes the user through a prescribed sequence of steps in order to learn a product". Perfect. What more to explain ? If you can't crack it, may be this one might make it a bit more clear - "a tutorial is a computer program whose purpose is to assist users in learning how to use (parts of) a software product such as an office suite or any other application, operating system interface, programming tool, or game or even a Tweaking Method ...etc".

2. Things To Do ?

A. : Somethings you need to do before you kick off.

> The first thing to do :

= select the topic. Choose a topic which people might like and relate it with. Either choose the topic for the audience or chose the audience for the topic you chose. Your call :smile:

> What do you want to tell your readers ?

= Put yourself in the reader's shoe and try to understand what they need? How they need? Collect your thoughts.

> To wat depth you would like to cover the topic ?

= There are 3 types of readers: novice, virtuoso and inbetween. Make sure you keep in mind all three types of readers. This is where a good intro will be useful. Always start with an intro! novice gets benefitted here, the others will not mind a recap.

> Use attractive stuff where ever you can. :biggrin:

= Links to appropriate pages would be really good. Don't try to explain tini little stuff. for ex. What is a comp?
= Images. As the famous saying goes, "One picture is worth a thousand words", very true. Pictures used as examples will surely help the reader understand better. These things will leave behind an everlasting impression and the reader will never forget the concept that easily. Use Any Images Hosting Website and embed the images on Your tutorial.

> Make the readers get involved.

= Ask simple questions to the readers. Make them use their mind as they read. This will also make them get involved.

> Use common words, don't try to show off your language skills.

=Just Keep it simple as possible since not all readers are widely open minded,some of the Internet users just type the thing they want to understand in Google,so if your Tutorial Link got in their hand,they will have a look at it !! You are a lucky person if they Bookmarked the page !! Also,be professional in terms of using English Language,don't Brag about using your Language Skills in writing misunderstood Words/Phrases,expect that a Low Language people might be reading your Tutorial by coincidence.

> Maintain constant tone, speed and style.

= Constant flow of ideas is very important. This is the Most Important part of this Guide,Just Keep it Smooth & Simple as possible,don't get away with your thoughts or Ideas,try to maintain a professional technique when explaining Idea/Past Experiences.

> For a start, stop looking too much into grammer and spell checks.

= Many of us read our work a 1000 times before posting it online. Here we might lose track of what we want to say and it might end up as junk. Be careful, thats enough !! As your write more, things will fall in place automatically. :wink:

> Overall, keep it simple, short and sweet.

3. Others stuff you might need ?

Nothing much here, Just read point 2 once again . If you still find it difficult to put down your thoughts, just give it a shot man, write what ever you feel like, people will reply asking a few questions. People might curse you, mock at you. Write them down. It will help you build on understanding what readers expect. You will grow for sure. trust me. :top:

Would Like to Finish Up This Guide With A Few Words :

"Communication is all about exchange of ideas. Grammar, Style, Attitude comes along with it. If you don't possess any of these, just exchange your ideas, you'll get these soon. Its just a matter of time" :biggrin:





Hope that I have offered a useful piece of Information to all of you guys,Just Keep your Frame In Range & Believe me you will do just FINE !! NJoy Tutorialing. :top:

anon
20.07.08, 19:12
Our TuT Master gives us some advice, hehe :biggrin: very very good. :wink:

hitman
20.07.08, 20:30
= Images. As the famous saying goes, "One picture is worth a thousand words", very true. Pictures used as examples will surely help the reader understand better.

this is probably the keyword on making a good tutorial dont write to much its quite annoying reading a lot a good mix of pictures and explainations is a good compromise