home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / comp / os / os2 / misc / 44071 < prev    next >
Encoding:
Internet Message Format  |  1993-01-25  |  2.7 KB
  1. Path: sparky!uunet!olivea!pagesat!spssig.spss.com!uchinews!ellis!sip1
  2. From: sip1@ellis.uchicago.edu (Timothy F. Sipples)
  3. Newsgroups: comp.os.os2.misc
  4. Subject: Re: Why are os/2 manuals so usless?
  5. Message-ID: <1993Jan25.175626.10733@midway.uchicago.edu>
  6. Date: 25 Jan 93 17:56:26 GMT
  7. References: <1993Jan20.100717.18052@monu6.cc.monash.edu.au> <1993Jan20.223633.21866@midway.uchicago.edu> <1993Jan25.072551.6055@digi.lonestar.org>
  8. Sender: news@uchinews.uchicago.edu (News System)
  9. Reply-To: sip1@midway.uchicago.edu
  10. Organization: Dept. of Econ., Univ. of Chicago
  11. Lines: 39
  12.  
  13. In article <1993Jan25.072551.6055@digi.lonestar.org> kgallagh@digi.lonestar.org (Kevin Gallagher) writes:
  14. >>In any event, I'm hearing that a "real" manual will be included in the
  15. >>2.1 shrinkwrap.  What appears to be a draft of the manual is on the
  16. >>2.1 beta CD-ROM.
  17. >I purchased a hardcopy of the 2.0 GA Command Reference manual (cost me nearly
  18. >$40!).  It is quite a bit easier to read and look up information in the
  19. >hardcopy version than in the on-line version, this is for certain.  (I grew
  20. >quite tired of chasing one reference after another, sometimes going in
  21. >circles, looking for the DETAILED information I needed, when I used the
  22. >on-line version!)
  23.  
  24. The price on this manual has been reduced, by the way.  I think it is
  25. more like $20 now.
  26.  
  27. >However, the Command Reference manual is skimpy, to say the least.  It is the
  28. >place to look up the syntax of a command you already know you want to use for
  29. >a particular purpose.  But don't expect to find any detailed technical
  30. >discussion of why and how you might want to use any of the commands!  And
  31. >don't expect to find many non-trivial examples of how to use the command.
  32. >Most commands have NO examples.  IBM gets a D- here on user documentation.
  33. >User documentation is one of the BIGGEST problems with OS/2!  Without
  34. >excellent user documentation which provides sufficient technical information
  35. >to isolate, diagnose, and fix most end user problems, OS/2 will fail.
  36.  
  37. Everybody makes things sound so black and white.  I'd agree with the
  38. last sentence if it said, "...OS/2 will be more likely to fail."
  39.  
  40. The documentation provided should be appropriate for the audience.
  41. IBM clearly misjudged this aspect of the product in 2.0; 2.1 will have
  42. a "real" manual.  However, we all can I agree (I hope) that the
  43. particulars on remote LAN installation from a Novell Server (for
  44. example) or writing an installable file system do not belong in the
  45. base product documentation.
  46.  
  47. -- 
  48. Timothy F. Sipples      | Read the OS/2 FAQ List 2.0i, available from
  49. sip1@ellis.uchicago.edu | 128.123.35.151, anonymous ftp, in /pub/os2/all/info
  50. Dept. of Econ., Univ.   | /faq, or from LISTSERV@BLEKUL11.BITNET (send "HELP")
  51. of Chicago, 60637       | [Read the List, THEN post to ONE OS/2 newsgroup.]
  52.