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:greatest good? From:Miki Magyar <miki -dot- d -dot- magyar -at- BANGATE1 -dot- TEK -dot- COM> Date:Tue, 30 Apr 1996 06:38:22 MDT
Stuart Burnfield asks if "the greatest good of the greatest number" is "a
fair summary of the best approach to technical communication". It might be
a fair approach to the best summary....
In practice, I have to consider an audience (for user manual, electronic
high-tech widgets) that will include novice users, pros, occasional users,
and who knows? The instruments are complex, and will do more than most
users might make use of. So all the features have to be documented, even
though 'the greatest number' might never need them.
The real question is how you decide what to put in and what to leave out,
or how do you define 'complete'. Again, in practice, this may be
constrained by costs, bureaucratic decree, supervisor's preferences, and
marketing whims. The TW who is trying to do a conscientious job will
include what the expert user will need, and organize it to accommodate the
needs of all audiences. (Fr'instance, putting the Theory Of Operation lump
as an appendix, instead of section 2.)
Interesting question! I suspect there will be numerous responses - I'm
curious to see how theory fits with experience.
Post Message: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
Get Commands: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "help" in body.
Unsubscribe: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "signoff TECHWR-L"
Listowner: ejray -at- ionet -dot- net