User documentation - drawings or photographs?

Subject: User documentation - drawings or photographs?
From: Geoff Hart <ghart -at- videotron -dot- ca>
To: techwr-l List <techwr-l -at- lists -dot- techwr-l -dot- com>, SB <sylvia -dot- braunstein -at- gmail -dot- com>
Date: Mon, 21 Jan 2008 20:30:12 -0500

Sylvia wondered: <<Originally all the graphics in our user
documentation (MS Word) were done done in Corel Draw (vector). We
slowly introduced photographs for procedures (Photoshop is easier)
but the tendency is to slowly replace drawings with photographs. Some
of these drawings were originally created because the product did not
exist yet but most products were simply drawn with Corel Draw. It was
my impression that vector graphics for user documentation was "more
professional" even if we try to have nice photographs of the products.>>

It's not really a question of "professional", but rather one of
effectiveness. Simplistically, photographs are most useful when you
want to show everything the eye will see, exactly as the eye would
see it. That's a "literal" image. Drawings are more useful when you
want to eliminate irrelevant details so readers can focus only on
what remains. That's called abstraction. The more details you need to
eliminate so that you can see only what the author wants you to see,
the more abstraction improves the effectiveness of the communication.

So the larger question is what product you're documenting, and what
amount of visual information is necessary to communicate the key
points. The less visual information you need, the more likely a
drawing will prove superior to a photograph. Some relevant articles
that might interest you:
http://www.geoff-hart.com/resources/2006/abstraction.htm
http://www.geoff-hart.com/resources/2007/words-plus-pictures.htm
http://www.geoff-hart.com/resources/2007/visual.htm


----------------------------------------------------
-- Geoff Hart
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
www.geoff-hart.com
--------------------------------------------------
***Now available*** _Effective onscreen editing_
(http://www.geoff-hart.com/home/onscreen-book.htm)


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

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-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


References:
User documentation - drawings or photographs?: From: SB

Previous by Author: Word graphics unclear in FrameMaker?
Next by Author: File protection from copying?
Previous by Thread: User documentation - drawings or photographs?
Next by Thread: Re: User documentation - drawings or photographs?


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

Sponsored Ads


Sponsored Ads