Re: Never lead with a graphic

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.

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.

RE: Never lead with a graphic: From: Rebecca Hopkins

Previous by Author: Re: Never lead with a graphic
Next by Author: Re: side-effect of tabbed browsing
Previous by Thread: RE: Never lead with a graphic
Next by Thread: Re: Never lead with a graphic

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

Sponsored Ads