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: An index in service manuals From:CEW Connie Winch <CEW -at- MACOLA -dot- COM> Date:Mon, 1 Jun 1998 10:35:14 -0400
Barry,
Do everything you can to convince them otherwise. Good information
loses its value and is not communicated when the audience can't easily
access the information they need, and an index is probably the most
useful (and therefore most used) access tool. If the powers that be
care about the users' gaining access to the necessary information so
that they can effectively use the product (and conceivably reduce the
amount of support needed), they care about indexes.
Good luck and please let us know what happens.
Connie E. Winch
Technical Writer
Macola Software
Marion, OH USA
cew -at- macola -dot- com
> -----Original Message-----
> From: Barry Kieffer [SMTP:barry -dot- kieffer -at- EXGATE -dot- TEK -dot- COM]
> Sent: Friday, May 29, 1998 1:43 PM
> To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject: An index in service manuals
>
> Greetings,
>
> A quick question to all of you TW's who create paper media service
> manuals:
>
> Do you include an index in the paper service manual?
>
> I have to admit, when I look at a manual, or go to look something up
> in a
> manual, I go right to the index first.
>
> Where I work, the powers that be have decided amongst themselves that
> service manuals may not contain an index.
>
> What are your views?
>
> TIA!
>
> Regards,
>
> Barry
>
> &^~~~
> Send commands to listserv -at- listserv -dot- okstate -dot- edu (e.g., SIGNOFF
> TECHWR-L)
>