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.
Conchan wonders: <<How do you decide, if an author has not handed in any
illustrations or photos, etc., whether they are needed or not?>>
Before you can decide, you need to understand the relative strengths of
words and images, and what options each medium provides for communication.
Well-chosen words with specific meanings can be far more concise than most
images ("a word is worth a thousand pictures") and their interpretation can
be much more objective; of course, it's also true that poorly chosen words
or words with a range of possible meanings can be both inefficient and
highly subjective.
On the other hand, skillfully created images work much better at conveying
qualitative or abstract concepts (colors, unusual shapes, and positions) or
conveying large amounts of data in a small space (graphs, photos). In these
cases, a picture really is worth a thousand words. Photographs provide "the
full picture", whereas diagrams eliminate many details to focus on the ones
the illustrator chose to focus on. (Photographers can "focus" on fewer
details, but have much less flexibility about eliminating details such as
surface texture.)
Determining whether text is sufficient depends on a thought process more
than on a rule: Examine the text, and determine whether it communicates
clearly and efficiently. Think whether you could say the same thing in less
space and with more clarity using an image. (This requires a knowledge of
the potential of images as extensive as your knowledge of words. Images too
have a vocabulary, and if you don't know that vocabulary, your ability to
communicate is limited.)
<<If they are how do you determine what kind of illustration or photo,
etc.,to use?>>
As noted above, there's no really good rule of thumb. The trick is to think
about the types of images you have available to use and evaluate whether any
of those options works well. The latter is a bit of a judgment call unless
you have (a) lots of experience knowing what works for your readers or (b)
the chance to test the image on your readers.
<<If the choice to use an illustration is chosen what do you use to tell the
author that an illustration would help the work and illustrator to make
preparation easier.>>
I propose the illustration, using my crude and primitive graphic talents if
necessary or my graphic artist to come up with a thumbnail if he's
available. I try to insist that he read the text before illustrating it, but
realistically, most graphics people hate reading and/or lack the time to do
it. That being the case, I sit down with him and explain the concepts,
sketch out what I mean, then let him create a good sketch to confirm that he
understood me.
--Geoff Hart, geoff-h -at- mtl -dot- feric -dot- ca
Forest Engineering Research Institute of Canada
580 boul. St-Jean
Pointe-Claire, Que., H9R 3J9 Canada
"Technical writing... requires understanding the audience, understanding
what activities the user wants to accomplish, and translating the often
idiosyncratic and unplanned design into something that appears to make
sense."--Donald Norman, The Invisible Computer
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Purchase RoboHelp X3 in April and receive a $100 mail-in
rebate, plus FREE RoboScreenCapture and WebHelp Merge Module.
Order here: http://www.ehelp.com/techwr-l
Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday TECHWR-L....
---
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.