Podcast: How to Create User-Centered Documentation, Interview with Joe Sokohl
May 30th, 2008 | Posted in Podcasts 15 Comments »
Download MP3
Duration: 15 min.
Audio clip: Adobe Flash Player (version 9 or above) is required to play this audio clip. Download the latest version here. You also need to have JavaScript enabled in your browser.
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.
In his experience, Joe found that almost no one used the user manual, but instead wanted quick information for specific tasks. The users hated stand-up training with PowerPoint slides (what the execs thought users needed), and instead wanted hands-on experience with the real system.
Creating user-centered documention requires technical writers to to break the standard (and ridiculous) rule of not contacting the user, to get out of their shells and interact and interview others, and to often challenge standards and assumptions from executives. It may be hard, but doing so is essential, because if you end up creating the wrong deliverables, all your efforts to create help may be irrelevant and useless.
In the podcast, Joe recommends a number of books:
- About Face, by Alan Cooper (cooperdesign.com)
- The Design of Everyday Things, by Don Norman
- Emotional Design, by Don Norman
- Observing the User Experience, by Mike Kuniavsky
- Communicating Design, by Dan Brown
- Blueprints for Information Architecture, christina Wodtke
- Information Architecture for the World Wide Web, Peter Morville and Louis Rosenfeld
For more information on Joe Sokohl, see his blog here. Also, I blogged about this presentation earlier here.
Tags: Joe Sokohl, user ethnography, User Experience
Twitter
Facebook
The podcasts I record for I'd Rather Be Writing cover the latest trends in technical communication. I interview tech writing luminaries around the world as well as record STC presentations and other audio content. You can subscribe to podcast specific feeds using the subscription information below.
Podcast page in iTunes














Auf I’d rather be writing ist ein neuer, interessanter Podcast (15 min) erschienen:How to Create User-Centered Documentation, Interview with Joe SokohlIn 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.
t even read user manuals, it is imperative your examples (or training) are constructed crystal clear … and with the true user in mind. With those thoughts I invite you to listen to both of these excellent podcastsHow to Create User Centric Documentation and Training. Using Video in Training and Documenation
今度絶対リベンジするぞぉ 次は 午前中にいきます ちょっとがっかりな散歩でした
achevé au niveau de la magnifique bibliothèque de la Casbah de Bgayet par la tenue d’un Workshop sur les Manuscrits (à Afniq n’Ccix Lmuhub – Tala Uzrar) organisé dans le cadre du projet Euro-Méditerranéen Aristhot (sciences en Méditerranée -http://www.aristhot.eu) et du projet de recherche : Modes de production et de transmission de la culture dans les sociétés Berbères – http://www.fsp.maghreb-france.msh-paris.fr) La problématique concernera en premier lieu les Manuscrits de langue Berbère de la
I have gotBoils info website
And of course an under the sea themed dance floor, complete with disco ball! In Cape May they could have their pictures taken in old fashioned costumes on the front porch of a Victorian house…In Sea Isle City they could have their fortunes told by a gypsy…. In Wildwood they could get tattoos (the boss and I made the tattoo parlor!) We even had some cruise directors…
- pil*bo*fl*gh* – 彌紗 – 佳奈 – rmi*i*18 -koron_4705- kamenashi yuki – 玲央-reo- – ★りか★ – min*ko_*sa*ka*19xx – 山田ミキ – run*ohi*e – ワゴ☆ – (*^▽^*)ゞおまっと3 – shi**pre*atione*22 – tom
What alternatives, let us say to manuals, Online Help, etc has this kind of research shown. Could you please let me know a few of them.
Suresh KVs last blog post..About Relationships
Joe said he ended up creating some quick captivate demos based on specific tasks users wanted. He arranged the demos as links in a table on a web page.
Interesting talk Joe Sokohl has. I actually read a few of the recommended books and they are worth reading for sure! I especially liked the books of Donald Norman and Cooper.
interaction design blogs last blog post..When poor usability services the user experience
[...] Podcast: How to Create User-Centered Documentation, Interview with Joe Sokohl Fri, 2008-05-30 06:46 Download MP3 Duration: 15 min. [...]
[...] Analyzing Your Users and Needs Before Creating the Help Deliverables; Interview with Nicky BleielPodcast: How to Create User-Centered Documentation, Interview with Joe SokohlThinking About a More Personal Style of PodcastingPodcast: Workspaces, Collaboration, and [...]
Documentation is very important. Especially when to comes to something new like podcasting. We have to face it. pocasting is a new trend. Not many people are using this method to communicate and documentation is essential in helping more people.
Laurens last blog post..Find Great Blogs
Thanks for the info. Lots of notes to review from your informative post.
[...] at Doc Train with his presentation changing the rules of the game to benefit the end user. I even interviewed Joe for a follow-up podcast, nodding in agreement with each sentence he [...]