Engineering design practice was RE: Trouble finding work

Subject: Engineering design practice was RE: Trouble finding work
From: "Kathleen" <keamac -at- cox -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 20 Apr 2005 16:59:05 -0700


I think that the proposition that good engineering design practice will
lead to user-friendly documentation is highly debatable.

IMHO, it's good design practice coupled with good content, and neither
is assured by any technique. The only assurance is having a "producer"
who can (and will) do that, though even the best of us (engineer or
writer/designer) can make mistakes. I agree that certain practices might
make it easier to establish a desired outcome, but they're far from
complete solutions.

(sheesh, I must really be bored to get embroiled in this)


Kathleen

-----
Tony Markos wrote:

The key consideration is whether technical
communications needs to be created using an
engineering approach. User friendly documentation is,
in the main, documentation that minimizes the reader
having to do skips and jump-to's. There is really
only one approach to creating such documentation:
Design highly cohesive and lossely coupled modules of
information. And creation of such modules requires
good engineering design practice.

Tony Markos

--- Al Geist <al -dot- geist -at- geistassociates -dot- com> wrote:

> >> As mentioned previously, there are usually two
> types of tech writers:
> >> 1- the engineer/programmer with a TW
> certification
> >> 2- the English/Journalism major with a back door
> into high-tech (e.g.,
> >>a hobbiest techie).
> >>
> >>
> I have a degree in journalism and I've worked as a
> business reporter,
> broadcast journalist and an award winning video
> producer. I also have
> over 37 years experience in the
> electronics/computer industry,
> including working as a Sr. Technical Writer and
> Publications
> Manager...so be careful when you lump
> English/Journalism majors in to
> the category of "a hobbiest techie." Some of the
> best technical writers
> I've known come from the journalism profession.
> Some of the worst were
> converted programmers/engineers.




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:
http://www.webworks.com/techwr-l

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



References:
Re: Trouble finding work: From: Tony Markos

Previous by Author: RE: Why should I be worried about the merger? NOT
Next by Author: RE: Definition of "User-Friendly" Was Re: Engineering design practice
Previous by Thread: Re: Trouble finding work
Next by Thread: Re: Trouble finding work


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


Sponsored Ads