Placement of question and answer sections in a user guide?

Subject: Placement of question and answer sections in a user guide?
From: "Hart, Geoff" <Geoff-H -at- MTL -dot- FERIC -dot- CA>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 20 Mar 2002 13:29:09 -0500

Douglas Bailey is <<...creating a software user guide, and am planning to
include a list of commonly asked questions, though not necessarily as an
official FAQ. Do you think it would make sense to include it at the front
of the document, immediately after the (quite small) installation section?
Or is the more traditional method (to include it at the back, perhaps as an
Appendix) better?>>

In a larger sense, it doesn't really matter where you put such things, so
long as everyone can find it easily. If the section is listed in both the
TOC and the index, you could put it on any random page and they'll still
find it. But:

<<I'm trying to help the user avoid having to think... when a user decides
he needs help with something, he generally has a question he wants

The overwhelming problem with any kind of FAQ is that it's inevitably
presented out of context and out of order; that forces users to skim through
it until they find the specific question they're seeking--if they find it at
all. If you really don't want the users to go through this painful task,
forget about the FAQ entirely, and answer the questions directly in the
documentation. If the user has a question about (say) the Print dialog box,
they turn to the index, look up the page for "Print dialog box", and
voila--they've found the question and answer.

More to the point, anything that becomes a frequently asked question sends a
strong message that your documentation isn't doing its job. Rather than
setting up an FAQ section, make sure that the main body of your
documentation answers each question you were going to put in the FAQ section
quickly and easily. That turns the FAQ into a "seldom asked question".

--Geoff Hart, geoff-h -at- mtl -dot- feric -dot- ca
FERIC, 580 boul. St-Jean
Pointe-Claire, Quebec
H9R 3J9
"Writing, in a way, is listening to the others' language and reading with
the others' eyes."--Trinh T. Minh-Ha, Woman native other

PC Magazine gives RoboHelp Office 2002 five stars - a perfect score!
"The ultimate developer's tool for designing help systems. A product
no professional help designer should be without." Check out RoboHelp at
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Techwr-l : The Movie <OT - humor>
Next by Author: Windows trademark news?
Previous by Thread: Re: Placement of Question and Answer Sections in a User Guide
Next by Thread: Windows TrademarkNews

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

Sponsored Ads