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.
RE: What do you guys think of STCs new definition for technicalwriter?
Subject:RE: What do you guys think of STCs new definition for technicalwriter? From:"Lauren" <lauren -at- writeco -dot- net> To:"'Mike Starr'" <mikestarr-techwr-l -at- writestarr -dot- com>, "'Bill Swallow'" <techcommdood -at- gmail -dot- com> Date:Tue, 27 May 2008 13:29:28 -0700
I still like mine better.
-------
Technical communication is communication of technical subject matter to
general or specific audiences using any variety of graphics, publication, or
media tools. A technical communicator is a person who performs any job or
holds any title within the field of technical communication.
-------
What value would more detail add? The qualifiers of "clear, concise,
comprehensive, accurate, correct, accessible, and professional" are
tautologous to the field of professional writing, so why do they need to be
stated? The statement of specific deliverables seems unnecessary because it
is both limiting and deceptively expansive. For example, requirements
documents are technical documents that do not seem to fit in or logically
follow from the list of sample documents and mentioning web sites, seems to
suggest that web developers are technical writers, which they are not.
The last sentence of your definition is a little convoluted because it
contains too much information. It mentions typical work environments for
technical communicators, but excludes government, it discusses technically
how the work is completed and follows with a repetitive list of examples
that gets a little confusing. Like, writing is not a technology but that is
one inference from the sentence. Also, the list of examples contains
unnecessary repetition, such as illustration and graphic design, which can
be replaced with something like, "graphics production." "Photography,
video, and sound" is "audio-visual production" or "audio-visual media."
I wonder about "tools and technologies" and "methods and technologies"
because the lines of distinction are a little blurry here. Define a
"technical communication method" and a "technical communication technology."
Also, what happened to the comma you were going to add in "technologies
including"? You could say, "technologies that include."
Lauren
> -----Original Message-----
> From: techwr-l-bounces+lauren=writeco -dot- net -at- lists -dot- techwr-l -dot- com
> [mailto:techwr-l-bounces+lauren=writeco -dot- net -at- lists -dot- techwr-l -dot- com
> ] On Behalf Of Mike Starr
> Sent: Tuesday, May 27, 2008 12:49 PM
> To: Bill Swallow
> Cc: TECHWR-L
> Subject: Re: What do you guys think of STCs new definition
> for technicalwriter?
>
> We had a bit of a discussion of this over the weekend. Sean
> did a rewrite and then I tweaked it as follows:
>
> Technical communicators create a variety of print and online
> documents that are clear, concise, comprehensive, accurate,
> correct, accessible, and professional. Typical deliverables
> include manuals, online documentation, proposals, policies
> and procedures, and websites. Technical communicators work in
> all types of businesses and industries around the world and
> use a variety of methods, tools, and technologies including
> writing, illustration, graphic design, photography, video, and sound.
>
> Mike
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-