RE: An observation about the writer-engineer relationship

Subject: RE: An observation about the writer-engineer relationship
From: "Hart, Rowena" <Hart -at- SelkirkFinancial -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 12 Oct 2001 11:12:43 -0700


# So the question I want to throw open for discussion is this:
# What is the relationship between these two very different
# ways of being in the world and what does it teach us about
# the way writers should approach engineers qua SMEs in order
# to have a successful working partnership?

Very interesting question. I've had a few opportunities
to learn about programming and computer system design.
One of the things that really amazes me about
programming is the complexity of the interactions
between elements in the system. One of the effects of
thinking at that level of detail is that you immediately
think of 142 different things that could have caused a

Writers, on the other hand, aren't exposed to the
intricacies of the relationships between elements, and
how the system is handling the data. We deal with a
very limited set of possibilities. The thing to
remember is that the SMEs defined the limited set
of possibilities that we deal with.

That said, one of the most important things to ask
a SME about their work is "Why did you do it that way?"
Another good question is "What happens to data that
is entered in this field?" It's amazing how quickly
your interruption turns into a productive peer-to-peer
discussion. The key is to assume that the SME had a
damned good reason for doing something a particular
way, and work from that. You can lobby for a better
user experience after you understand how the system
works and any technical limiations that have affected
the product implementation.



Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

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 for more resources and info.

Previous by Author: Writing: better or worse after years on the job?
Next by Author: RE: FWD: Layoff logistics and etiquette
Previous by Thread: RE: An observation about the writer-engineer relationship
Next by Thread: Re: An observation about the writer-engineer relationship

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

Sponsored Ads