Re: What sayest me... on Worthless TC Degrees

Subject: Re: What sayest me... on Worthless TC Degrees
From: "Tim Altom" <taltom -at- simplywritten -dot- com>
To: "John Posada" <jposada01 -at- yahoo -dot- com>, "TechDoc List" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 24 Mar 2000 15:03:12 -0500

John, I think you may be overstating the case.

If a manual is utterly task-based and properly designed for that, an index
is of questionable value. But many manuals have long sections of exposition,
with loads of technical terms and other things that obscure the points the
user may want. Many manuals are written like third-party books, almost all
of which have (and need) indexes. This isn't necessarily "poor" structure.
It's just expository structure.

Tim Altom
Simply Written, Inc.
Featuring FrameMaker and the Clustar(TM) System
"Better communication is a service to mankind."
Check our Web site for the upcoming Clustar class info

> An index is only that useful when the content of the
> book itself is so bad that it doesn't make sense.
> How is needing a section of the book to find a section
> of the book a good thing.
> Don't get me wrong...indexes are important...only
> because books are structured so poorly. If the book
> was arranged well, the index wouldn't be needed.

Previous by Author: In defense of tech doc education
Next by Author: Structure: Was...What sayest me...
Previous by Thread: Re: What sayest me... on Worthless TC Degrees
Next by Thread: Re[2]: What sayest me... on Worthless TC Degrees

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

Sponsored Ads

Sponsored Ads