PureBlogging » Blog Archive » Make Your Tutorials into Must-have Resources

Tutorials get links, because people find them so useful. But there are many tutorials on blogs everywhere. How will yours stand out and become a must-have resource? In this article, I’m going to cover some important tips and techniques to help you make sure your next tutorial blog post is a killer resource that your readers will link to and bookmark. Here’s what we’re going to cover:

  1. Your Tutorial Must Meet a Need
  2. Use The Three T’s
  3. Address Learning Modalities
  4. Taking Steps
  5. Test Runs
  6. Duration

1. Your Tutorial Must Meet a Need

You must create a tutorial about something people really want, or they will never link to it and bookmark it. You have several ways of finding out what people want to get ideas for tutorials:

  • Emails your readers send you, asking specific questions
  • Questions your readers ask in the comments
  • Questions people ask on social media sites
  • Paying attention to trends: for example, the trend in tutorial posts getting high numbers of links
  • Your own observations about what is under-served… an under-served audience is likely to be appreciative.

2. Use The Three T’s

The Three T’s are:

  1. Tell them what you’re going to tell them.
  2. Tell them.
  3. Tell them what you told them.

This is a deceptively simple yet effective way to structure your tutorial according to the adult learning model. I’ve spent over seven years as a computer training and courseware specialist, and it works. Let your audience know what they’re going to be in for, present the material in the same order, and simply review it afterwards. Telling your audience what topics will be involved in advance removes any surprises and gives your audience a mental framework to hold memories. It gives them a sense of anticipation of what’s to come and that helps to keep their attention.

When you present the steps of your tutorial, you will be meeting your audience’s expectations, instead of surprising them or violating them. This gives them the feeling that they’re in control and keeps them comfortable. Your audience is getting exactly what they expected, and they expected it because you told them what to expect.

After you present the main steps in the tutorial, you want to help your audience feel satisfied with the tutorial. You do this by reviewing the main points. This reinforces the tutorial’s main points in a way that aids in retaining the material, plus it helps to provide an emotional sense of closure regarding the information. Your audience will mentally and emotionally confirm for themselves that they got what they wanted and what they expected.

You will notice that this tutorial is, of course, following this format!

3. Address Learning Modalities

Successful tutorials address the different learning styles (modalities) people have. Some people learn best by reading, others learn best by watching examples, and still others learn best by hearing the words. Addressing more than one modality is important for your tutorial to be as effective as it can be. A common way to do this is to provide pictures to accompany the written text.

Now bloggers can add video and audio to their tutorial posts as well, plus a host of other methods for engaging the different ways peopel learn, such as slide shows (SlideShare) or animation (Animoto). The review portion of this tutorial will feature a multimedia SlideCast in addition to the text.

4. Taking Steps

Before a person can follow the steps of your tutorial, how should they prepare? Make sure you provide the proper set up information they need. When you’re providing step-by-step instructions, use numbered lists so people can follow instructions in the correct order. Keep any images or video that are tied to a specific step within that step’s instructive text–you’ll confuse your readers as to the correct order if you separate them from each other.

5. Test Runs

Just like people who create recipes must test them in order to ensure their results are reproducible, so too should you test your tutorial by following its steps through from beginning to end. Our tendency is to sort of gloss over this. “Yeah, yeah, I know all this! I wrote it!” The best way to do this is to step away from your tutorial for a day or two and then follow it with fresh eyes. You will spot some aspects that need to be changed or improved. Put yourself in the mind of a person who needs the tutorial, someone who doesn’t already know what you know.

Better yet, get such a person to test it out for you. Social networks are great for this. Your friends might be willing to help you out. Their feedback will be invaluable. If this seems like a lot of work, well, it is, but if you want your tutorial to be seen as a go-to resource, you’ve got to put the effort and time into it. You can’t just slap it together and hope people like it.

6. Duration

The time it takes someone to go through your tutorial is an important consideration. It should take no longer than 45 minutes at a maximum. Any longer than that, and people will begin to lose patience and their ability to focus will waiver. If what you’re doing is extensive, break it up into parts. Make sure your readers know it is in multiple parts, and that they understand what part they’re currently reading. Once all the parts are done, provide links to them all in each one (side note: stuff like this makes for great ebook material).

Tutorials Get Links if You Do Them Right

People love to link to tutorials in their own blogs and spread them via social networks such as Digg and Twitter. Let’s review the main highlights of this one, via SlideShare:

Thanks for reading! If you have any tutorial-writing tips of your own, feel free to share in the comments! Happy tutorializing!

Popularity: 9% [?]

Subscribe to RSS Feed

RSS feed

12 Comments

Comment by Christine OKelly Subscribed to comments via email
2008-03-18 12:30:55

This is awesome Micheal. I’m getting ready to create a few tutorials and this definitely was a great refresher and gives me a structure to work within!

 
Comment by Kevin Ott Subscribed to comments via email
2008-03-18 12:54:14

Addressing learning modalities is, to my eye, the most important aspect of your tutorial, and one I never considered in a static model like the Web. (It’s easier to address separate ways of learning if you’re actually teaching an hour-long class).

I know that, as helpful as video is, it’s often more difficult to work with as a tool, particularly with the video apps available on the Web, which tend not to have very precise controls (it’s often hard to pause in a very specific place, for example). I work best with a set of instructions that I can refer back to.

I’d also add that two very important details are TONE and ANTICIPATION OF COMMON DIFFICULTIES. I like to keep things friendly and upbeat, but if you’ve failed to anticipate some problem a user might have, that tone can turn on you quickly. I’ve been frustrated by more than one tutorial whose creator cheerfully informed moved on to Step Four without warning me that Step Three might take a few hours.

Great post overall — thanks.

Comment by Michael Martine
2008-03-18 13:07:51

Wow, great tips, Kevin! I especially appreciate the one about anticipating difficulties. Spot on. :)

 
 
Comment by The User
2008-03-18 13:49:36

The thing I kept thinking about was the issue of grammar and spelling. There’s been numerous times when I’ve been reading through a how-to or tutorial and the spelling is just atrocious and I think to myself: “If they can’t spell worth a damn, why I am trusting their knowledge on this topic?”. Sure, it maybe a little short sighted on my end, but there are so many sources of information out there, and one needs a way to discern what’s valuable and what isn’t.

Another thing is layout. Your post has nice section headers, lists when necessary, etc. Too many tutorials seem to forgo this crucial step. It makes it much easier to look back at them and find the specific information you’re looking for.

Comment by Kevin Ott Subscribed to comments via email
2008-03-18 15:42:16

Have to agree with all of this.

“If they can’t spell worth a damn, why I am trusting their knowledge on this topic?”

I feel this way about the entire Internet. I’m sure it’s to my detriment in some regard, because I’ll write off a blogger’s entire body of work, but seriously: If you systematically misspell words or use lousy grammar, that means you probably don’t read very much, or you don’t pay attention when you do read. And if you’re not a reader, what the hell are you basing your thoughts on?

Comment by Michael Martine
2008-03-18 16:21:49

There are many kinds of intelligence. I’ve read some amazing things from people who cannot write correctly, but who can communicate nonetheless (Shoemoney comes to mind). It can be an annoyance, no doubt, but it’s no indicator of talent or intelligence.

(Comments wont nest below this level)
Comment by Kevin Ott Subscribed to comments via email
2008-03-18 16:56:35

I agree that someone’s ability to write well isn’t a reliable indication of intelligence. I know plenty of people way smarter than me who can’t write worth a damn, and plenty more people who are so advanced in their field they can’t communicate more simple concepts.

I just don’t like fighting with people’s writing. I don’t like having to slow down and read sentences twice in order to understand them, when a simple punctuation mark could have made the whole process much easier. I don’t like wondering how a writer expects me to take him or her seriously if they haven’t learned to spell simple words like “definitely” and “ridiculous” (two of the most oft-misspelled words I’ve ever seen on the Web). Just about everything has a spellchecker, so what gives? I’m not judging anyone’s intelligence — just their willingness to communicate their ideas in a way that doesn’t seem messy and unfinished.

As I said, I may be doing myself a disservice, because I tend to blow someone off after about the third or fourth misspelling or run-on sentence. But ideas tend to trickle down in the blogosphere. Good ideas (bad ones, too) are repeated and expanded upon, sometimes by bloggers more adept at the written word.

 
 
 
 
Comment by SEO dude
2008-03-18 15:18:53

There are so many combinations of 3 Ts i have not even heard this one before.

And most importantly you need to know the subject you are talking about :)

 
Comment by Cyndee Haydon Subscribed to comments via email
2008-03-18 22:36:49

Michael – thanks for a great guide for building tutorials – the irony is we usually write about those things we know best and it’s easy to “assume” a few things that the reader may not know – I love the idea of having someone “test” it – takes me back to my days as an integration tester :)

 
2008-03-19 03:27:48

I find that my tutorial style posts are often my most popular but sometimes I whip them together quite quickly and don’t put in enough effort. One thing I really want to try is adding some video and so far all I have used is text and images.

 
Comment by videos
2008-03-19 03:57:13

Michael has told about things which everyone know, but for some reason often do not realize on their blogs :cry:

 
2008-06-08 00:08:11

[...] 18th 2008 2:31pm [-] From: pureblogging.com [...]

 

Sorry, the comment form is closed at this time.