RE: A dark take on Tech Writing...do you agree?

Subject: RE: A dark take on Tech Writing...do you agree?
From: "Leonard C. Porrello" <Leonard -dot- Porrello -at- SoleraTec -dot- com>
To: <klhra -at- yahoo -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>, "Gene Kim-Eng" <techwr -at- genek -dot- com>
Date: Wed, 5 Nov 2008 11:45:23 -0800

I think it is an uncalled for slight to alien engineers. If there are
any aliens who are knowledgeable about humans, I wonder if they say
things like, "What a piece of garbage; what did you do, have it designed
by humans?!"

Leonard ;-)

-----Original Message-----
From: techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- c
om] On Behalf Of Keith Hood
Sent: Wednesday, November 05, 2008 11:36 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com; Gene Kim-Eng
Subject: Re: A dark take on Tech Writing...do you agree?

Good line - I'm working on a story where I can use that after I file off
the serial number.

I have also seen my share of things that seemed designed to violate the
tenets of known good development methods. They seem to cluster in
projects run by and for government agencies.

I've worked places where all the technical writing was under the control
of the sales & marketing group. The logic in each place was, most of the
company's technical writing was for the use of customers (help systems,
white papers, etc.). That meant the CRM aspects of the documents were
paramount, so the docs had to be done according to guidelines determined
by the marketing people. In those places the work seemed to go pretty
much the same as in other companies - the main difference was in having
to make it more the content more "personable" than it might otherwise
have been.


--- On Wed, 11/5/08, Gene Kim-Eng <techwr -at- genek -dot- com> wrote:

> I've
> encountered many products that convinced me they sprouted
> from some sort of alien pod rather than from an engineering
> process.
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

References:
Re: A dark take on Tech Writing...do you agree?: From: Gene Kim-Eng
Re: A dark take on Tech Writing...do you agree?: From: Keith Hood

Previous by Author: RE: Is there a study on reading warnings, notes?
Next by Author: RE: Is there a study on reading warnings, notes?
Previous by Thread: Re: A dark take on Tech Writing...do you agree?
Next by Thread: Re: A dark take on Tech Writing...do you agree?


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


Sponsored Ads