Documentation Review Techniques (videocast)
I believe that in order to learn something, you have to do it, for the most part. So forgive me if my first dozen videocasts here are experimental, because I'm learning. I'm finding that video is a little trickier than I thought.
To create video, you first need some type of video camera (obviously). I have a Sony handycam camcorder that I bought in 2000 and never really used much -- until now. It records on miniDV tapes rather than a hard drive, and I can only transfer captured video via a firewire cable to my computer. In 2000, we paid about $600 for the camcorder. Now I believe I could walk into any pawn shop and get the same camera for $60.
There is so much to video. What program to use, what format to publish it, the video service, getting video in iTunes, and so on. This is my video learning phase, so bear with me. Just last night, while exploring the little hidden compartments on the camcorder, I discovered the microphone port I'd been looking for. It accepts a 1/8th inch microphone jack. Unfortunately I discovered the microphone port after I recorded the video.
A little explanation about the videos. There are two videos, answering two reader's questions. The first reader writes,
I'm getting ready to publish my Manuals and was wondering if you go through a process of review, a checklist before you publish your manuals. If you do, it'd be great if you could share it. I'm sure your other readers would greatly benefit from it.
Here's my videocast response:
Another reader asks a related question:
In my organization, we have a set of controlled documentation. Changes that need to be made are requested through an Engineering Change Notification application. As part of our process, we mark the requested changes in the document with red text and a black change bar along the left margin. We are reviewing our process, and are looking for better ways (if any) to mark changes in the document.
Here's my videocast response:
These videos are actually my second recording. I initially tried recording at about 6 p.m., which is prime family time in the Johnson household. I learned that trying to record while family is up and about is challenging. My oldest daughter made rabbit ears behind me, Shannon made cookies and clanked dishes, my four-year-old grabbed the camera and drove a stroller around the kitchen. I started over a few times and finally made it through an entire recording, but there were too many distractions.
If you prefer to listen to these videocasts as a single MP3 file in your iPod instead, here's an MP3 recording of much better quality.
Download MP3 (to download, right-click and select Save Target As)
Length: 14 min.
If you have any comments about documentation review techniques or tips for creating videocasts, please leave your comments below.
I'd Rather Be Writing Newsletter
Get new posts delivered straight to your inbox.
About Tom Johnson
I'm a technical writer based in the California San Francisco Bay area. In this blog, I write about topics related to technical communication — Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, academics, and more. I'm interested in simplifying complexity, API documentation, visual communication, information architecture and findability, and more. If you're a technical writer of any kind (progressional, transitioning, student), be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.