Re: Definition of "User-Friendly" Was Re: Engineering design practice

Subject: Re: Definition of "User-Friendly" Was Re: Engineering design practice
From: Al Geist <al -dot- geist -at- geistassociates -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 20 Apr 2005 21:52:43 -0600

While loosely coupled modules may work in some situations, to say there is "only one approach" is too simplified. This process may work when writing engineering documents for engineers, but there are so many other audiences out there and not all of them think (or want to think) like engineers. I will agree that user friendly documentation minimizes the reader having to skip and jump all over the place, but the personality of the audience is a very important element that should not be overlooked. Advanced users require material to be presented differently than beginning users. Online documentation is presented differently than print documentation. There's just to many variables to lump them into a "one method for everything" approach.


Tony Markos wrote:

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 loosely coupled modules
of information. And creation of such modules requires
good engineering design practice.


Al Geist, Geist Associates
From Concept to Completion
Technical Writing, Online Help Applications, Marketing Collateral, Web Design, Award Winning Video, Professional Photography
Office: 505-294-8855

Cell: 505-400-4128
E-mail: al -dot- geist -at- geistassociates -dot- com <mailto:al -dot- geist -at- geistassociates -dot- com>

"When the situation is absolutely hopeless, you have nothing to worry about."
Compliments of The Monkey Wrench Gang


Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo:

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

Definition of "User-Friendly" Was Re: Engineering design practice: From: Tony Markos

Previous by Author: Re: Why should I be worried about the merger?
Next by Author: Re: What Can We Do?
Previous by Thread: Re: Definition of "User-Friendly" Was Re: Engineering design practice
Next by Thread: Re: Definition of "User-Friendly" Was Re: Engineering design practice

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

Sponsored Ads