Re: Effective use of video in software tutorials?

Subject: Re: Effective use of video in software tutorials?
From: "Peter Neilson" <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Sat, 31 Mar 2012 07:13:17 -0400

On Fri, 30 Mar 2012 22:27:18 -0400, Keith Purtell
<keithpurtell -at- keithpurtell -dot- com> wrote:

... [no] full start-to-finish video. So my question is, what are some suggestions for the criteria I develop to decide what parts of my documentation would be best supplemented by video?

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
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.

dd if=/dev/narrator/mind of=/dev/null

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 @

Effective use of video in software tutorials?: From: Keith Purtell

Previous by Author: Re: Training and documentation teams play well together?
Next by Author: RE: Is "untar" an acceptable verb?
Previous by Thread: Re: Effective use of video in software tutorials?
Next by Thread: TechWhirl Technical Communications Recap for March 31, 2012

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

Sponsored Ads