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: 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.
> 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-