Re: Effective use of video in software tutorials?

Subject: Re: Effective use of video in software tutorials?
From: Keith Purtell <keithpurtell -at- keithpurtell -dot- com>
To: Peter Neilson <neilson -at- windstream -dot- net>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sun, 01 Apr 2012 01:04:36 -0500

Each and every reply I've gotten had ideas I'll putting to good use. And, as always, Peter has skewered those who who do this kind of thing badly with scathing wit. Having suffered through several awful YouTube tutorials, I found his re-creation screamingly hilarious.


On 3/30/2012 10:13 PM, Peter Neilson wrote:

Start by studying existing software tutorial videos you can find on
YouTube. Examine the really bad ones, and then anti-emulate them. There
is a tendency of the producer to believe that showing stuff on video
makes it transparently obvious.

The video narrator knows where he is going to move the cursor, but the
viewer does not. Thus a script like this one is especially annoying:

As you can see [NO, I CAN'T. WHERE?] we've got the frobnatz here. So we
just move over here [WHERE?] and right-click to bring up the, oops, we
didn't get it. There. It's docked to the left side. I hope it's not off
we just enter the number from before [I DIDN'T SEE THAT. WHAT NUMBER?
WHERE?] and click over here [LIKE, WHERE?] and we're done. Next we'll
show how to use it in the gazoing-ploot.

Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.


You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Previous by Author: Re: Title case in documentation
Next by Author: RE: a good book on ISO documentation?
Next by Thread: Re: Effective use of video in software tutorials?

What this post helpful? Share it with friends and colleagues:

Sponsored Ads