15 Ways of ruining your tutorial, a beginner’s guide

I thought the tutorial writing world needed to know really how to write those bad tutorials, and how to do it properly. I can’t get enough of bad tutorials and love it when I see 40 “tutorials” in a row rejected from the same website. Here’s to you old pals…

1. Always start with ‘This is my first ever tutorial” or “I just learned this yesterday”

An opening paragraph can be the maker or breaker of a tutorial, and for me to read that you’re new to whatever subject you’re trying to teach or that you’re new to writing tutorials doesn’t really fill me with confidence. Use your opening paragraph to outline your tutorial and what you will teach, not to persuade users not to read on.

2. M15pe1 eev3ry w0rD wr0ng

Yes you’re ‘l33t’, but we have the power to call your mother and tell her you’ve been a bad boy. Eat that with your cereal before school.

3. Make ads more important than the tutorial/content itself

Simply put, when a reader is actually reading the tutorial you’ve written, they actually want to read the tutorial… not ads about Viagra and fetish websites. Advertisement are all right to support the tutorial but don’t let it get in the way.

4. Save all your images poorly

The fuzzy feeling should be inside us when we read your tutorial, not all over the image we are trying to view.

5. Go one step further and host them on a free image host

It comforts us to know you’ve gone through all the effort of paying $10 a month for a host… it really does. It means that you’ll be around longer than the refresh of a page.

6. Always use pixel text and fonts below 9px in size

“Whats all those white lines going across the content area all about?”

7. If you’re going to use dark text, make sure you use a dark background or if you’re going to use light text, make sure you use a light background

Honestly… who can read light red on light blue?

8. If you’re going to use syntax highlighting, make sure it’s impossible to read

The colours are meant for a white background, if you’re not using a white background… customise the colours properly. If you’re using syntax highlighting on something as silly as a dark grey background then how are people supposed to see the code in the first place?

9. Keep it short and sweet

“Is that it?” You don’t want to be told that in bed and you sure as hell don’t want to hear it from somebody reading your tutorial. Now do what you did to solve the bedroom problem and put some effort and work into those tutorials.

10. Make sure you tell the user “we are going to use this, if you don’t know it, go and learn” at least once during the tutorial

If a teacher told you to go and learn wouldn’t you tell him to teach you in the first place? I sure would.

11. Promote your friends’ sites consistently

We only read tutorials to get more useless sites to look at and your friends’ tutorial sites let us know just which sites to avoid in the future.

12. Skip steps

“So we start with this and end with this, tutorial done”… Everyone is psychic nowadays so why teach them what they’ve come to learn?

13. Host it on a forum full of 500kb “animated” sigs that are the size of desktop wallpapers

Those sigs just bring life to the page and really shine through your professional side. In truth, if you showed anything close to a “signature file” in a professional interview they would send you back to your local grocery store for extra training.

14. ALWAYS give your tutorial a name that has nothing to do with the tutorial itself

Readers will hate you for giving them Britney Spears when they are looking for Oasis.

15. Finally, always complain to a tutorial listing administrator that your tutorial was declined at

Yes you thought it was a good tutorial, but we didn’t. Rejection is harsh but so is your site being labelled as ‘ran by that crazy guy’.

To end, I hope people writing all these bad tutorials see my point, and really start to actually listen to the complaints constantly left on their tutorials.

15 Responses

  1. Pingback on

  2. Tiago

    Well that actually should open the eyes of every “bad” tutorial writer ;)
    Nice article jay, had a lot of fun reading it :)

  3. Dark

    Well Said,
    Also those sites that Bombard the User with PopUps
    .. I am teaching them something so might aswell make some money, who cares about what they think or the quality of this! …

  4. Pingback on

    Computer Dave

  5. Jay

    Note

    I will be considering extra parts to this tutorial to advance it further so suggestions on extra steps are welcome :)

  6. Mike Wilson

    ” Those sigs just bring life to the page and really shine through your professional side. In truth, if you showed anything close to a “signature fileâ€? in a professional interview they would send you back to your local grocery store for extra training. ”

    Thank you!

    Another thing is taking game “renders” and putting them in “sigs” which is illegal. And for tutorials, when you start and say, ok, take this brush, I don’t know where it is from, and do stuff until you get something that is totally different and that no one that hasn’t “brushed” before would understand.

    I’m done..

  7. Ribbon

    Hi, nice article to learn someone how to write decent tutorials, can I post it on my website?, this site will be mentioned and credited.

  8. Jay

    Hey Ribbon,

    Whatever happened to a simple link? :)

  9. VR88

    Highly amusing. I guess the life of a tutorial indexing site administrator is a frustrating one!

  10. Ribbon

    OK that’s fine for me thanks,

  11. .Zetrom

    Hahaha, great tutorial. Made me laugh.

  12. Michael

    I’ve seen a number of tutorials that follow your ‘guidelines’ (sarcasm – those tutorials weren’t written too well). Perhaps we should pay a little bit of attention.

    5. Go one step further and host them on a free image host

    It comforts us to know you’ve gone through all the effort of paying $10 a month for a host it really does. It means that you’ll be around longer than the refresh of a page.

    Somehow I manage with $3.33/month hosting ,were I get 3 GB of space for anything I could possibly want (well, the usual exceptions – no porn, warez, etc.).

  13. Pingback on

    Pinky Programmer » Blog Archive » Probably……..

  14. Naruto Wallpaper

    Nice Blog..I’ll read this more on daily bases :)

  15. Richard

    Hey i have an awesome program i use for making tutorials its called Camtasia Studio

Comments are closed, but feel free to @jhuskisson on Twitter with your thoughts.