Re: Quick Reference Material in User Guide?
I'm contemplating adding some quick reference material inside the user
guide. These blocks of material would be like a quick summary of the tasks
that are rather compex. These would interspersed throughout a chapter as
need and would be in adition to the chapter summaries.
I haven't used this technique, but I don't think I would.I suppose that I could design so that the quick references were highly visible, but, on the whole, I wouldn't go to the effort.
My reasoning: a quick reference is supposed to be quick. Having to flip through the chapter to find the summaries probably ensures that finding the information won't be quick.
Besides, the introduction to a procedure generally summarizes it anyway.
A quick reference and a complete reference have two different purposes, so you probably shouldn't try to mix them. Trying to do so only complicates things for you while doing little for the users.
Bruce Byfield bbyfield -at- axionet -dot- com 604.421.7177
"Paranoia does wonders for your imagination."
- Tom Holt, "Little People"
Experience RoboHelp X3! This new RoboHelp release combines single sourcing,
print-quality documentation, conditional text and much more, into the most
monumental release of RoboHelp ever! http://www.ehelp.com/techwr-l
Enhance, optimize and automate your FrameMaker-to-PDF workflow with TimeSavers:
Define all PDF features in your source FrameMaker files ONCE, distill MANY.
Bookmark Controller, Link Controller, UnBloat & more : http://www.microtype.com
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
http://www.raycomm.com/techwhirl/ for more resources and info.
Quick Reference Material in User Guide?: From: Jim Hager
Previous by Author:
Re: Documenting field descriptions in printed documentation
Next by Author: Re: Check the checker
Previous by Thread: Quick Reference Material in User Guide?
Next by Thread: Re: Quick Reference Material in User Guide?
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites