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.
--- Daniel Hall <misterhall -at- prodigy -dot- net> wrote:
> Sorry, my post was truncated.
>
> My second questionis, should the "general info"
> section come at the
> beginning or end?
> It makes a good intro, but as several folks have
> already mentioned, lots of
> readers skip the intro. Does it make sense to have
> it at the end as a sort
> of "if all else fails?"
I suppose you could put it in both places. Some will
read it at the beginning. Others will catch it at the
end. Most will probably continue to skip it.
Okay, that was a little facetious. In truth, I would
put the information where it makes the most logical
sense in the organization of the document. You might
also consider titling it something more descriptive
than "Introduction." As you rightly pointed out, lots
of people skip Introductions.
How many more people might read a section titled,
let's see, how about "If All Else Fails"? Or perhaps
"The Most Important Chapter" or "The Key To Winning
$50,000 is in This Section." (Okay, okay...I'm
getting out of hand, but you see the point, eh?)
=====
Tom Murrell
Senior Technical Writer
Alliance Data Systems
Columbus, Ohio mailto:trmurrell -at- yahoo -dot- com
__________________________________________________
Do You Yahoo!?
Send online invitations with Yahoo! Invites. http://invites.yahoo.com
