RE: [TechWhirl Forums] Authors who cannot write

Subject: RE: [TechWhirl Forums] Authors who cannot write
From: Lynne Wright <Lynne -dot- Wright -at- tiburoninc -dot- com>
To: Dan Goldstein <DGoldstein -at- cytomedix -dot- com>, "TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 13 Nov 2013 19:18:15 +0000

Very Hemingway-esque in its simplicity and truth

-----Original Message-----
From: techwr-l-bounces+lynne -dot- wright=tiburoninc -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+lynne -dot- wright=tiburoninc -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Dan Goldstein
Sent: Wednesday, November 13, 2013 2:18 PM
To: TECHWR-L (techwr-l -at- lists -dot- techwr-l -dot- com)
Subject: RE: [TechWhirl Forums] Authors who cannot write

"I had at least one thing in common with Joseph Conrad: English was my second language. Unlike Conrad, I had no first language."
-- Kurt Vonnegut

For many engineers who were born and raised in the US, English is their second language, and Engineering is their first language. This happy fact keeps technical writers employed.


-----Original Message-----
From: Lynne Wright
Sent: Wednesday, November 13, 2013 2:03 PM
To: Alec Chakenov; Peter Neilson
Cc: techwr-l
Subject: RE: [TechWhirl Forums] Authors who cannot write

Are you referring to SMEs expressing what they mean in their own language? That's how you end up with documentation that users can't understand... because the writer just paraphrased what an engineer or programmer said. Which, in my case, because my SMEs' first language often isn't English, would result in incomprehensible text.

Similarly, SME reviewers will often approve text that they think is ok (because they completely understand how a feature works), without realizing that it's confusing, unclear, or full of holes to somebody who's coming at the material with zero knowledge.

The tech writer has to understand what they are documenting so that they can explain it in clear simple language. It's the opposite of letting your SMEs basically write the text for you verbally.




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as Lynne -dot- Wright -at- tiburoninc -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
[TechWhirl Forums] Authors who cannot write: From: TechWhirl Community Forums
Re: [TechWhirl Forums] Authors who cannot write: From: Gene Kim-Eng
Re: [TechWhirl Forums] Authors who cannot write: From: Peter Neilson
Re: [TechWhirl Forums] Authors who cannot write: From: Alec Chakenov
RE: [TechWhirl Forums] Authors who cannot write: From: Lynne Wright
RE: [TechWhirl Forums] Authors who cannot write: From: Dan Goldstein

Previous by Author: RE: [TechWhirl Forums] Authors who cannot write
Next by Author: RE: Standards for command-line documentation + dumb Acrobat X user question
Previous by Thread: RE: [TechWhirl Forums] Authors who cannot write
Next by Thread: Re: [TechWhirl Forums] Authors who cannot write


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


Sponsored Ads