Determining When to Use Show-Me Helps and Demos

The availability of powerful yet easy-to-use multimedia tools enables technical writers to consider a powerful new form of embedded user assistance: show-me help. This paper provides an overview of who is currently using show-me help--some current research, some history, and some definitions. It offers some guidance in choosing tools, designing show-me help, and deciding when to include then, concentrating on consideration of your users, potential topics, subsequent releases, and translation. It also suggests how show-me helps can be reused as part of product education and single-sourced into user assistance from the Web.

Bradford, Annette Norris. WritersUA (2005). Articles>Documentation>Multimedia>Video

Enhancing Documentation with Video  

Presents guidelines for developing videos from technical material and discusses the process of video production.

Steiner, Leonard T. Intercom (2004). Articles>Documentation>Multimedia>Video

Jump into Digital Video for Multimedia   

Digital video (DV) is relatively easy and inexpensive to produce and has an expanding role in technical communication. It is a powerful media for communication and can be included in favorite online formats such as WinHelp, HTML help, Acrobat (PDF), and web pages, as well as training presentations produced with tools such as Asymmetrix Toolbook and Macromedia Authorware. Delivery of DV spans a range of electronic media including CD, DVD, and the Internet. New technology offers the potential to synchronize the presentation of video, audio, and other multimedia forms. This paper introduces DV concepts. It gives practical tips for investing in DV equipment and producing video and audio.

Robbins, David B., Kathleen Wyrwas and Alice Davinich. STC Proceedings (1999). Articles>Documentation>Multimedia>Video

Putting the Poetry of Film to Use Online  

This article helps technical communicators become better informed producers of interactive, cinema-like new media objects (help systems, public information and ordering kiosks, promotional technical presentations on the web, and so on) by providing a summary of how cinema works, and then by proposing a few ways that some basic cinema editing and display techniques can be integrated into on-screen technical communications practice. The author makes the claim that if we are to begin thinking and working like film makers, the fundamental poetics and information designs we use in our new media design and development work must also change.

Gillette, David. STC Proceedings (2005). Articles>Documentation>Multimedia>Video

How I Create Video Tutorials

Creating video tutorials is no trivial task. When you sit down to create 20+ video tutorials for a project, you’re faced with dozens of questions. What screen size should the videos be, what recording tool should you use, what microphone is best, how long should the videos be, what file size is acceptable? Should you use voice or captions? Where will you create the recording? You can create video tutorials using dozens of different methods. There are no official steps to create videos, because situations and audiences vary so widely.

Johnson, Tom H. I'd Rather Be Writing (2008). Articles>Documentation>Multimedia>Video

How Video Can Turn Your Career Around

When I talk to most technical writers, video is a format they haven’t done much with. This surprises me, because I find that, as a user, video tutorials are often the most helpful type of material for me to learn software. Video most closely simulates the universal desire we have for a friend to show us how to do something in an application. Perhaps I’m a visual learner, but the majority of us (some say 60 to 65 percent) are visual learners. But video doesn’t appeal only to end users. Video can be an appealing format for technical writers as well. Creating videos can turn your career around, especially if you find technical writing a little dull.

Johnson, Tom H. I'd Rather Be Writing (2009). Articles>Documentation>Multimedia>Video

Video, Documentation, and You

Video has the potential for enhancing documentation. But is video the be all, end all? Is it really the next stage in the evolution of documentation? Will it supplant text and static images? This post looks at the pros and cons.

Nesbitt, Scott. DMN Communications (2009). Articles>Documentation>Multimedia>Video