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: Never lead with a graphic From:"Gene Kim-Eng" <techwr -at- genek -dot- com> To:"Tech Whirlers" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Tue, 8 Jul 2008 13:49:49 -0700
Great, how much do we want to bet that it's going to turn
out to be all based on the personal opinion of some teacher
and textbook author who hasn't written an actual manual
since CP/M. :)
Flipping through some past docs I've produced, I seldom
lead off a section with a photo, line drawing or flowchart
graphic. I usually don't use lead-in text before screencaps
in SW instructions. And in my last few online help projects
I didn't even use screencaps. But none of these have ever
been hard and fast "standards." Sometimes one scheme
seems to work better, and sometimes a different one does.
Gene Kim-Eng
----- Original Message -----
From: "Rebecca Hopkins" <rebecca_hopkins -at- comcast -dot- net>
> I talked to one of my younger co-workers, and he said that's
> what he learned in school as well - never lead with a graphic.
> He could not remember the rationale, however. Since the boss
> is newer to the tech writing circus than I am, I'm thinking she
> also "received" this wisdom that I missed out on.
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-