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: Issues with illustrations? From:Jim Jones <han4yu3 -at- gmail -dot- com> To:Rick Lippincott <rjl6955 -at- gmail -dot- com> Date:Fri, 6 Feb 2015 15:54:13 -0600
First -- The best way to include text with illustrations allows for
the text blocks to be editable. This method allows both for easy
updating and also for easy translation/localization of the
illustrations in a document.
Sadly not all illustrations are created this way, even today.
Second -- illustrations should be simple and direct.
Jim Jones Linkedin.com/in/jimxlat cartoons-jim.blogspot.com
Editing and Technical editing
Chinese, German, and Spanish to English
Illustration and Cartooning
STC and ATA
On Fri, Feb 6, 2015 at 3:32 PM, Rick Lippincott <rjl6955 -at- gmail -dot- com> wrote:
> This is coming from a hardware point of view. Problems I see are:
>
> * Too much reliance on photographs. Sure, photos are the easiest to
> produce, but they're also the easiest to goof up. Contrast, focus, and
> exposure all need to be right.
>
> * No consistency in the way information is called out. Some use index
> numbers tied to a table with the nomenclature, some use nomenclature
> text in the illustration. Those that use text in the illustration can
> become busy and difficult to read.
>
> * Changes to the subject aren't always updated in the illustrations.
> Object configurations change, but the writers aren't always able to
> capture the changes in doc revisions. Nothing says "I was...
>
>
> On 2/5/15, Steven Jong <stevefjong -at- comcast -dot- net> wrote:
>> I am collecting information for a presentation at the STC New England
>> regional conference (InterChange). I am going to discuss current best
>> practices and issues with illustrations in technical communication. ..
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015