Re: "Manuals?" "Bulletins?" "Guides?" What?

Subject: Re: "Manuals?" "Bulletins?" "Guides?" What?
From: Martyn Thirlway <thirlwaym -at- USOFT -dot- NL>
Date: Thu, 22 Aug 1996 16:25:00 PDT

Eric wrote:

What do you call your manuals?

I have been through this with so many companies, who had standards that I
actually did not agree with...
It all depends on what the manual is about - the title should make it
clear.For example, "XXX Compiler Guide" means nothing, while "How to use the
XXX Compiler on YYY" does. Is it an instruction manual, a reference manual,
a bulletin (advance info, for example), a sales document, a brochure, a
"read me first", an "additional notes", or what?

At my present company we have Guides, which are "How to use" manuals,
Reference Manuals, which are just that (somewhere to refer to), Additional
Notes (last-minute information), and so on.

All you have to do is choose a title that is clear, concise, and complete:
if your readers don't come back with a question about the title, then you
have probably got it right.

Martyn Thirlway
thirlwaym -at- usoft -dot- nl
Author of "Writing Software Documentation - A Practical Guide"
["This writing business, pencils and what-not. Overrated if you ask me."
Eeyore]

TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-



Previous by Author: Re: Pencil Test for Technical Writers
Next by Author: Re: Information Mapping
Previous by Thread: Re: "Manuals?" "Bulletins?" "Guides?" What?
Next by Thread: Re: "Manuals?" "Bulletins?" "Guides?" What?


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

Sponsored Ads


Sponsored Ads