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: Persuasive writing From:Michael Lewis <lewism -at- BRANDLE -dot- COM -dot- AU> Date:Mon, 24 Nov 1997 11:09:44 +1100
Andriene elizabeth Ferguson-addei wrote:
> ... I am interested in your opinions on the use of persusasion in technical
> writing. In particular,
>
> -- Should persuasive writing/prose be used in technical documents, and if
> so when?
>
> -- Are there particular industries/documents where persuasive writing is
> acceptable in the preparation of technical documents (e.g. to persuade the
> audience to use one product over the other)?
>
> --Is there a role for the technical writer to play in the preparation of
> marketing or advertising copy?
Much depends on your definition of "persuasion" and "technical". For
example, much marketing and advertising material for hi-tech products
includes quite detailed technical stuff. There are also issues of
persuasion in encouraging people to follow certain courses of action,
and / or avoid others, because of undesirable consequences (sometimes
undesirable for the reader, sometimes for the product manufacturer etc.)
Then, most overtly technical documents directed to product purchasers
will include material that is essentially persuasive in purpose --
extolling the ease-of-use, capability, or flexibility of the product.
However, this is not likely to happen in internal-type documents such as
specifications.
So, in short: Yes, it is sometimes used (though whether it "should" be
is a more subjective issue); most industries will provide examples of
persuasion in some document types; and tech writers often do have a part
to play in the development of marketing and advertising material.
--
Michael Lewis
Brandle Pty Limited, Sydney, Australia
: PO Box 1249 : Suite 8, The Watertower :
: Strawberry Hills, NSW 2012 : 1 Marian St, Redfern 2016 :
: Tel +61-2-9310-2224 : Fax +61-2-9310-5056 :