Analyzing Your Users and Needs Before Creating the Help Deliverables; Interview with Nicky Bleiel

In this podcast, Nicky Bleiel says we should talk to as many users as we can — conducting on-site visits, sending surveys, gathering information from Marketing, Support, and other departments — so we can have a better understanding of our users’ needs and the formats and mediums that will work best for them. After completing this audience and needs analysis, we can then go out and create the deliverables that will best serve our users.

Bleiel, Nicky and Tom H. Johnson. Tech Writer Voices (2008). Articles>Interviews>Documentation>User Centered Design

Harry Miller on Multimedia Documentation

Miller, a technical editor at Microsoft interested in multimedia documentation, talks about why multimedia documentation is a growing trend and how writers can get started. He discusses Microsoft's Channel 9 and the human element with instructional screen demos.

Miller, Harry and Tom H. Johnson. Tech Writer Voices (2007). Articles>Interviews>Documentation>Multimedia

How to Create User-Centered Documentation, Interview with Joe Sokohl

In this podcast, Joe Sokohl explains how to create user-centered documentation by contacting, observing, and interviewing users to gather information about what types of information they use and the help deliverables they actually want.

Sokohl, Joe and Tom H. Johnson. Tech Writer Voices (2008). Articles>Interviews>Documentation>User Centered Design

Mike Brazill on Writing for Developers

Brazill gives tips for writers who document APIs or write other information for developers. He says that because developers are busy and want to get started, you have to write less and provide more examples. Developers are more goal-oriented than task oriented. He also explains the different levels of API writing.

Brazill, Mike and Tom H. Johnson. Tech Writer Voices (2007). Articles>Interviews>Documentation>Podcasts

Podcast: Using Video in Training and Documentation, Interview with Todd O’Neill

In this podcast, rich media specialist Todd O’Neill explains how to add video to your training and documentation deliverables. Many technical writers are intimidated by the learning curve, equipment costs, and software they think they need to create video, but actually you can create engaging videos with minimal equipment (e.g., $150 for a Flip video camera) and using software you probably already have (e.g, Windows Movie Maker or iMovie). In this podcast, Todd lays out the basics for those who know nothing about video. He explains the equipment you need, techniques for minimizing editing time, ways to publish the video online, filming techniques to focus on, and creative ways to package your video for your users.

O'Neill, Todd and Tom H. Johnson. Tech Writer Voices (2008). Articles>Interviews>Documentation>Multimedia

In Conversation with Adam Hyde

A conversation between Scott Nesbitt of DMN Communications and Adam Hyde, who runs FLOSS Manuals. In a wide-ranging conversation, they talk about why Adam started the project, the way in which FLOSS Manuals gets things done, Book Sprints, Adam’s thoughts on the 80/20 rule, and more.

DMN Communications (2008). Articles>Interviews>Documentation>Podcasts