🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: comp.sys.atari.st
Article #36539

Documentation Survey

#36539
From: Joel Kahn
Date: Tue, 14 Feb 1989 19:01
35 lines
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!JCD715T

Show 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