Re: Effective use of video in software tutorials?
... [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
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
your video. [WHAT IS IT? YOU NEVER SAID A NAME. WHY DO WE NEED IT?] So 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.
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
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/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
Search our Technical Writing Archives & Magazine