Re: "It Ain't Literature, Y'know" (#740579)

Subject: Re: "It Ain't Literature, Y'know" (#740579)
From: "Glanbrok, Slayer of Bluntskulls" <conehead -at- OVERTHE -dot- NET>
Date: Thu, 8 Aug 1996 12:07:39 -0400

Shmuel Ben-Artzi wrote:

Imagine your audience, a single engineer or technician, sitting in front of
you. Now, think about how you would explain the procedure to them. Why
should a written procedure be all that much different than a verbal one?



Because:

1. In person, you can use gestures, intonations, repetition, rephrasing, and eye contact to convey meaning and get feedback.

2. A written manual must be able to stand on its own (or at least be part of a set of written docs), which requires careful phrasing, unambiguous wording, correct diction, clear syntax, and all the other aspects that tech writers are supposed to have mastered.

Oops! No time to think up more reasons!

conehead -at- overthe -dot- net

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: Naming conventions
Next by Author: Re: Pencil Test for Technical Writers
Previous by Thread: Re: "It Ain't Literature, Y'know" (#740579)
Next by Thread: Re: "It Ain't Literature, Y'know" (#740579)


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

Sponsored Ads


Sponsored Ads