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: Designing a new help system -- Oh boy! ...ugh From:John Posada <jposada01 -at- yahoo -dot- com> To:Kathi Jan Knill <Kathi -dot- Knill -at- template -dot- com>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 2 Dec 1999 09:42:47 -0800 (PST)
Hi, Kathi:
I have a screen shot in every help window. Why? Not so
they can look at the image and screen and verify that
they match, but because I've also defined each field
and button in the image as a hotspot and when they
click on the hotspot, they get a popup that explians
what it's for and what the rules are for entering
information in that field. It is easier than listing
each field and the expalination on the page.
--- Kathi Jan Knill <Kathi -dot- Knill -at- template -dot- com> wrote:
> Renee asked for help with these issues:
>
> 1. Screen shots, good or evil --
> I think they are evil! If the user is accessing
> help, he is already at the
> screen he needs to know about. It can be more
> confusing if even one
> tiny detail is changed between what he sees and what
> is in the screen shot.
> I feel very strongly about this ... it is a pet
> peeve.
=====
John Posada, Merck Research Laboratories
Sr Technical Writer, WinHelp and html
(work) john_posada -at- merck -dot- com - 732-594-0873
(pers) jposada01 -at- yahoo -dot- com - 732-291-7811
"The art of creating software that is usable by individuals is a communication skill. It is not a programming skill."
--Bill Atkinson, creator of MacPaint and HyperCard
__________________________________________________
Do You Yahoo!?
Thousands of Stores. Millions of Products. All in one place.
Yahoo! Shopping: http://shopping.yahoo.com