Re: Graphics vs Text

Subject: Re: Graphics vs Text
From: Chris Borokowski <athloi -at- yahoo -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 15 Aug 2007 08:53:51 -0700 (PDT)

My preference, after some years of contemplation, is to get as close to
PowerPoint-style bullet lists and definition blobs with frequent
illustrations as possible. If I could, I'd also include video or

The reason is very simple. I want manuals to be a learning exercise,
not a reading exercise. People have little time, and are often under
the gun looking something up on the spot rather than reading the manual
as a whole for information. Given the state of most manuals, they're
not going to do that anyway.

In my world, Ikea-style illustration instructions could be done well,
even PowerPoint can be made redeemable, and while I love to write
descriptive text, it is best in small blobs associated with discrete
entities like definitions, steps, or conditions.

--- Ben <baj357 -at- gmail -dot- com> wrote:

> So to revive an older discussion
> conerning graphics vs. text in online help, what is the dominant
> philosophy about using graphics (with minimal text) to instruct users
> vs. using text only?
technical writing | consulting | development

Building a website is a piece of cake. Yahoo! Small Business gives you all the tools to get online.

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.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

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

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 for more resources and info.

Graphics vs Text: From: Ben

Previous by Author: Video game manuals
Next by Author: Why FrameMaker came back, and what's next
Previous by Thread: Graphics vs Text
Next by Thread: RE: Graphics vs Text

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

Sponsored Ads