RE: Numbered Callouts

Subject: RE: Numbered Callouts
From: "CB Casper" <knowone -at- surfy -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 03 Feb 2005 05:51:42 -0800


Various comments included:
>> Sometimes illustrations would be illegible if every item had its name
as the callout. Using numbers can simplify a drawing.<<

>> Seems that no matter what the general rule, they all end up looking
like the fifth type. (random) ;) <<

Pare the drawing down to only what is needed for what the user
needs at that point in the manual. Yes, this will create many more
illustrations, and a much longer document, but any opportunity
for confusion, and Murphy's Law will raise it's ugly head.

This is not a trivial task at times, for it involves taking a full size
engineering drawing, selecting only those portions of the drawing
that are useful and redrawing it to suit your audience.

Engineering drawings are intended for multiple audiences, and
contain far more information that a typical end user needs,
regardless of who the end user is.

The action of moving the eyes from the drawing of the item number
to the list of items can be very confusing and some numbers look
very much alike, depending on the font used.

When I was creating instructions for a machinist to create a
part from scratch, I only provided enough information for each
step to be able to perform that step. Anything else got in the
way of the machinist and they assumed that if was on their
instructions, they needed it.

Direct information, where they need it, when they need it,
and nothing more.

CB - writing for software is very different than hardware,
but the same principle applies


--
http://www.surfy.net for Free Email <br> http://www.ergova.com for Low Prices on Hotels, Books, and more.

Powered by Outblaze

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

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
http://www.webworks.com/techwr-l

Technical Communication Certificate online - Malaspina-University College, Canada. Online training in technical writing, software (FrameMaker, RoboHelp, Dreamweaver, Acrobat), document & web design, writing manuals, job search. www.pr.mala.bc.ca/tech_comm.htm for details.

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

Previous by Author: RE: HTML or PDF?
Next by Author: Re: Standards of converting to metric
Previous by Thread: Re: Numbered Callouts
Next by Thread: Photos instead of drawings; was: Re: Numbered Callouts


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


Sponsored Ads