Article View: comp.sys.atari.st
Article #36539Documentation Survey
From: Joel Kahn
Date: Tue, 14 Feb 1989 19:01
Date: Tue, 14 Feb 1989 19:01
35 lines
1955 bytes
1955 bytes
I am working on a proposal to add to the curriculum here at
Southwest Missouri State University a course in writing
computer documentation. The course, as currently envisioned,
would deal with both hardware and software docs, and would
focus primarily on satisfying the needs of the non-technical
end user. The course would be offered by the English department,
but might be included in the degree programs of other
departments: Computer Science, Communication, etc.
In order to provide evidence for the need for this course,
I'm gathering information on the attitudes of users towards
the state of computer docs today. Anyone who would like to
assist me can do so by answering the following questions:
1) On the usual scale of F to A, what overall grade would you
give to the docs you've used over the past few years?
2) What is/are the most common, persistent, and/or destructive
problem(s) you've encountered in these docs?
Please send your responses directly to me, as I'm sending
this poll out to several lists and I'm not a member of all
of them. For some of the ones to which I do belong, I hope
to do a summary of responses if volume thereof is sufficient.
I would also be grateful if anyone who has direct experience
with this kind of course--as teacher, student, whatever--
would give me useful advice.
Disclaimer: My opinions don't reflect those of SMSU, or those
of anyone else who disagrees with me . . .
Joel Kahn
jcd715t@smsvma
Technical Details
Message-ID:
<8902141913.AA26486@ucbvax.Berkeley.EDU>Path:
arc1-ca.pugleaf.net!utzoo!utgpu!jarvis.csri.toronto.edu!mailrus!tut.cis.ohio-state.edu!ucbvax!SMSVMA.BITNET!JCD715TShow Full Headers
Complete Article Headers
Path: arc1-ca.pugleaf.net!utzoo!utgpu!jarvis.csri.toronto.edu!mailrus!tut.cis.ohio-state.edu!ucbvax!SMSVMA.BITNET!JCD715T From: JCD715T@SMSVMA.BITNET (Joel Kahn) Newsgroups: comp.sys.atari.st Subject: Documentation Survey Message-ID: <8902141913.AA26486@ucbvax.Berkeley.EDU> Date: 14 Feb 89 19:01:39 GMT Sender: daemon@ucbvax.BERKELEY.EDU Organization: The Internet Lines: 35