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: 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?
Building a website is a piece of cake. Yahoo! Small Business gives you all the tools to get online. http://smallbusiness.yahoo.com/webhosting
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-