Podcast: How to Create User-Centered Documentation, Interview with Joe Sokohl
May 30th, 2008 | Posted in Tech Writer Voices |
Download MP3
Duration: 15 min.
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.
Related Posts
- Changing the Rules of the Game for the Benefit of the User
- Latest Podcast Is Posted on Tech Writer Voices
- Podcast: Five Books to Add to Your Technical Communication Library
- Podcast: Using Video in Training and Documentation, Interview with Todd O’Neill
- Understanding Principles of Usability, Part 1 — Karen Bachmann
Tags: Joe Sokohl, user ethnography, User Experience
Podcast in iTunes
Follow me on Twitter

May 30th, 2008 at 10:25 pm
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
May 31st, 2008 at 12:57 am
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.
May 31st, 2008 at 6:58 am
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.
May 31st, 2008 at 7:50 am
- 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
May 31st, 2008 at 3:33 pm
今度絶対リベンジするぞぉ 次は 午前中にいきます ちょっとがっかりな散歩でした
June 1st, 2008 at 4:18 pm
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
June 1st, 2008 at 4:24 pm
I have gotBoils info website
June 1st, 2008 at 4:31 pm
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
June 2nd, 2008 at 3:24 am
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
June 7th, 2008 at 10:16 pm
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…
June 11th, 2008 at 5:51 am
[...] Podcast: How to Create User-Centered Documentation, Interview with Joe Sokohl Fri, 2008-05-30 06:46 Download MP3 Duration: 15 min. [...]
June 26th, 2008 at 7:35 am
[...] 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 [...]
August 6th, 2008 at 9:42 am
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
August 12th, 2008 at 11:13 am
Thanks for the info. Lots of notes to review from your informative post.