TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: Making them read the documentation From:Christine -dot- Anameier -at- seagate -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 27 Apr 2001 15:34:06 -0500
Paul Goble offered this alarming anecdote:
> After working with a graphic designer to develop
> a visually attractive quick-start guide, we were
> horrified to see usability test subjects
> *literally* toss our work aside. "Marketing stuff,"
> they grumbled. "Now where's the manual?"
This strikes fear into my heart. I've come to believe that most people
react positively to good design, whether they're consciously aware of it or
not. I'm in the process of finishing a 150-page manual that is loaded with
screen captures (cropped, annotated, and often drop-shadowed) and
painstakingly laid out, and I would hate to have users dismiss it as
marketing fluff just because it isn't ugly.
Paul, was there anything in the *content* that users could have possibly
mistaken for marketing fluff? For example, I've seen manuals that begin
with sales pitches (overt or thinly veiled) and "about this manual" stuff.
To me, an "our [fabulous] product will help you blah blah blah more
effectively" overview smells like marketing.
Or did your quick-start guide get right to business immediately?
What proportion of your subjects overall reacted negatively to the visual
design of the guide? Did you have any test subjects with the opposite
reaction? (....she said, with a last glimmer of hope.)
Man, now I'll be fretting about this all weekend... ;)
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available 4/30/01 at http://www.devahelp.com or info -at- devahelp -dot- com
Sponsored by DigiPub Solutions Corp, producers of PDF 2001 Conference East,
June 4-6, Baltimore, MD. Now covering Acrobat 5. Early registration deadline
April 27. http://www.pdfconference.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.