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.
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.
steve
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
> 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 >
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
