Re: Re[2]: More personable tech writing

Subject: Re: Re[2]: More personable tech writing
From: Stephen Bernhardt <sbernhar -at- NMSU -dot- EDU>
Date: Thu, 11 Nov 1993 09:24:46 -0700

Personable may have the wrong connotations for what we are after. We
know that users can be helped by appropriate governing metaphors that help
them build an appropriate and useful model of how the system works. We
also know that scenarios are frequently helpful, especially as new users
are introduced to ways that features of an application might be exploited.

It helps, too, if a manual and index adopt anticipated user's terms while
tying them to the
application's terms. A good doc package helps users speak a shared
language with the application.

So I would say we would like documentation that works well in human terms,
that recognizes and responds to the ways that people tend to learn best.
Such documentation will feel natural and comfortable because it is
designed with human intelligence.


> Stephen A. Bernhardt >
> Department of English, Box 3E >
> New Mexico State University >
> Las Cruces, NM 88003 >
> 505-646-2027 FAX 505-646-7725 >
> e-mail sbernhar -at- nmsu -dot- edu >

Previous by Author: Re: Indexing Online Books: Cost Effective?
Next by Author: Re: TECHWR-L Digest - 10 Nov 1993 to 11 Nov 1993
Previous by Thread: Re: More personable tech writing
Next by Thread: Re: Re[2]: More personable tech writing

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

Sponsored Ads