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.
Deborah E-S. Hemstreet
Technical Writer Contractor, RCM Technologies
Kaydon Custom Bearings
Phone: (231) 755-3741 x217
Fax: (231) 759-4102
Mobile: (616) 828-6388
E-Mail: dhemstreet -at- kaydon -dot- com
The data contained in, or attached to, this e-mail, may contain
confidential information. If you have received it in error, you should
notify the sender immediately by reply e-mail and delete the message
from your system. Please do not copy it for any purpose, or disclose its
contents to any other person.
An e-mail response to this address may be subject to interception or
monitoring for operational reasons or for lawful business practices.
I think the issue is, though, that the partial screen captures are TOO
partial.
If I have the tooltip and part of the toolbar, with the top part of the
window, I am more likely to locate the command, than just seeing the
tooltip floating in space.
Partials can work - it just depends on how wisely they are cut...
Deborah
-----Original Message-----
From: techwr-l-bounces+dhemstreet=kaydon -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+dhemstreet=kaydon -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Boudreaux, Madelyn (GE Healthcare,consultant)
Sent: Tuesday, September 16, 2008 2:35 PM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Cc: Combs, Richard
Subject: RE: Screen captures (was RE: TECHWR-L Digest, Vol 35, Issue 14)
Combs, Richard wrote:
>I've seen far too many manuals crammed full of these kinds of useless
>illustrations. I've seen manuals with screen shots of every stupid
>notification or error message -- for instance, the text "A message box
>informs you when the XYZ process is finished" is followed immediately
>by a screenshot (complete with figure number and caption). It's a popup
>containing the words "XYZ process finished" and an OK button. How does
>that picture help anyone?
The user who easily digests the written word understands the text, while
the user who better understands visual aids understands better with the
pop-up. A verbal person may not see the difference between the words in
a paragraph and the words in a box, but the visual learner DOES see the
difference, and is potentially aided by such.
By providing both, you help both types of learners to use your
documents, which is more than just an attempt to add pages and get paid
more. (I hate voice-overs on tutorials, and always turn them off, but
for people who need to hear the words to better process the material,
I'm glad that the option is included.)
***
This discussion really suggests that a new study is needed. However,
people seem to be missing that they did the follow-up study in 2004,
only 4 years ago (I mentioned it in my initial comment). Can anyone find
that study?
Also, bear in mind that the researchers didn't expect the results they
got, either.
ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial. http://www.componentone.com/DocToHelp/
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as dhemstreet -at- kaydon -dot- com -dot-
ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial. http://www.componentone.com/DocToHelp/
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-