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.
I doubt I could improve on the clear steps to structured writing that
Sharon Burton and Dick Margulis have already posted.
I would add only that all tech writing requires the ability to ask your
SME an intelligent question and listen carefully to the answer. If the
answer leaves you in the dark, rephrase your question for clarification.
If you repeat the same question, you're liable to leave the unfortunate
misapprehension that you didn't hear the answer.
I've met many SMEs who needed help articulating their answers. Haven't
met many tech writers who needed help rephrasing the question, so I
guess that's a skill that's common in the field.
-- Dan Goldstein
(Won't rise to the bait again)
> -----Original Message-----
> From: Tony Markos
> Sent: Tuesday, December 13, 2005 3:05 PM
> To: Dan Goldstein; TECHWR-L
> Subject: RE: Structuring Documentation
> What are the basic steps to structured writing
> (formatting aside)?
> --- Dan Goldstein <DGoldstein -at- riverainmedical -dot- com>
> > Tony, many of us work every day with intelligent
> > people who are
> > perfectly capable of performing an analysis, but are
> > completely
> > incapable of expressing their analysis in writing.
> > Not the same, not
> > even nearly the same.
> > -- Dan Goldstein
> > > -----Original Message-----
> > > From: Tony Markos
> > > Sent: Tuesday, December 13, 2005 2:53 PM
> > > To: Dick Margulis
> > > Cc: TECHWR-L
> > > Subject: Re: Structuring Documentation
> > >
> > > If structured writing (formatting considerations
> > > aside) is the same or nearly the same as analysis,
> > > then the term serves no purpose other than to
> > create
> > > confusion...
> > >
This message contains confidential information intended only for the use of the addressee(s). If you are not the addressee, or the person responsible for delivering it to the addressee, you are hereby notified that reading, disseminating, distributing, copying, electronic storing or the taking of any action in reliance on the contents of this message is strictly prohibited. If you have received this message by mistake, please notify us, by replying to the sender, and delete the original message immediately thereafter. Thank you.
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l