Re: Tech Writing Question

Subject: Re: Tech Writing Question
From: Tom Murrell <trmurrell -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 19 Apr 2002 06:26:27 -0700 (PDT)


--- Bonnie Granat <bgranat -at- editors-writers -dot- info> wrote:
>
> What about technical writers who *write* specifications? I know of at least
> one person who does that (a former colleague). Does one need intimate
> knowledge of programming languages to perform that job? I do not qualify for
> most of the jobs I'm seeing advertised currently, but I'm wondering if
> writing specs might be something I could do.

I would say that if you know, or are given a chance to learn, enough about the
systems, processes, industries, and so forth, for which you would be writing
specifications, that, yes, you could write them. I assume, when reading a
spec., that the author knows what she is talking about as far as the system,
architecture, and processes are concerned. Spec. authors may not know how to
write very well--some do and some don't--but they do have a base SME knowledge
to draw on.

What a TW who is not intimately versed in the technical aspects of an area may
bring to the process is clearer, more focused writing. Possibly, you could
start out copyediting specs while you learn the subject matter and gradually
move toward spec writing as you learn the technical foundation you need to be
able to write various specs.

Now that I think about it, in some environments you could write the specs,
because they come from some other document. It depends on what a specific
organization means by specifications.

=====
Tom Murrell
mailto:tmurrell -at- columbus -dot- rr -dot- com
Personal Web Page - http://home.columbus.rr.com/murrell/index.html
Page Last Updated 03/14/02
--Can't we all just get along?--Rodney King

__________________________________________________
Do You Yahoo!?
Yahoo! Tax Center - online filing with TurboTax
http://taxes.yahoo.com/


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Are you using Doc-to-Help or ForeHelp? Switch to RoboHelp for Word for $249
or to RoboHelp Office for only $499. Get the PC Magazine five-star rated
Help authoring tool for less! Go to http://www.ehelp.com/techwr

Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.


References:
Re: Tech Writing Question: From: Bonnie Granat

Previous by Author: Re: Goodbye TECHWR-L
Next by Author: Re: Needed: one-liners in response to ...
Previous by Thread: Re: Tech Writing Question
Next by Thread: Re: Tech Writing Question


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


Sponsored Ads