Thinking like a user, or sticking to tried and true?

Subject: Thinking like a user, or sticking to tried and true?
From: "David Castro" <thejavaguy -at- gmail -dot- com>
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 21 Dec 2006 06:32:17 -0500

I am working on a short document that is going to be used to train
some network technicians on how to copy settings from one router to
another. The documents that this document was based on have had an
overview section at the beginning. The document that was delivered to
me to edit & format didn't have any content in this section, but I
could fairly easily create content based on the rest of the document.

However, in thinking about what my users are like (my SMEs are also
net techs), I realize that they're going to immediately skip the
overview and jump right into the nitty gritty. So, the question is
whether to think like a user and leave off the overview, or create one
because "there's always been one" and because "it's good practice to
start by telling them what you're going to tell them and end with
telling them what you told them."

Which do you do when you're faced with this decision? And why?

--
-David Castro
thejavaguy -at- gmail -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help format plus PDF, HTML and more. Flexible, precise, and efficient content delivery. Try it today! http://www.webworks.com/techwr-l

Create HTML or Microsoft Word content and convert to Help file formats or printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: Re: Measurable objectives?
Next by Author: Re: I don't know a rinky dink application so I'm not a good fit
Previous by Thread: Multi Language Support in RoboHelp
Next by Thread: Re: Thinking like a user, or sticking to tried and true?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads