home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #23 / NN_1992_23.iso / spool / misc / writing / 3125 < prev    next >
Encoding:
Internet Message Format  |  1992-10-09  |  3.1 KB
  1. Path: sparky!uunet!mcsun!uknet!doc.ic.ac.uk!agate!usenet.ins.cwru.edu!gatech!concert!sas!mozart.unx.sas.com!saslpo
  2. From: saslpo@stevens.unx.sas.com (Leonard Paul Olszewski)
  3. Newsgroups: misc.writing
  4. Subject: Re: Refs to Tech writing
  5. Message-ID: <BvtGnB.HzK@unx.sas.com>
  6. Date: 8 Oct 92 18:57:10 GMT
  7. References: <7510@charon.cwi.nl>
  8. Sender: news@unx.sas.com (Noter of Newsworthy Events)
  9. Organization: SAS Institute Inc.
  10. Lines: 64
  11. Originator: saslpo@stevens.unx.sas.com
  12. Nntp-Posting-Host: stevens.unx.sas.com
  13.  
  14.  
  15. In article <7510@charon.cwi.nl>, keesh@cwi.nl (Kees van't Hoff) writes:
  16. |> Hi,
  17. |>
  18. |> I am looking for some good references to books on technical writing, writing
  19. |> user manuals etc.
  20. |> Tutorials, guides and handbooks are all welcome.
  21. |>
  22. |> Thanks in advance,
  23. |>
  24. |> Kees.
  25. |>
  26. |> --
  27. |> Kees van 't Hoff, CWI, Amsterdam, the Netherlands.
  28. |>
  29. |> keesh@cwi.nl
  30.  
  31. Here are a few I've found helpful.
  32.  
  33. _Technical Report Writing Today_, Pauley/Riordan, Houghton-Mifflin,
  34.                                   1987, ISBN: 0-395-34251-1
  35.  
  36. Very good discussions of all of the various forms of technical writing,
  37. including proposals, technical definitions, using tables and graphs,
  38. writing instructions. Includes several sample formats, with exercises.
  39. Has sections on information accessability and retrievability - an often
  40. neglected but very important topic.
  41.  
  42. _How to Write a Computer Manual_, Jonathan Price, The Benjamin Cummings
  43.                                   Publishing Company, Melo Park, CA
  44.                                   1984, ISBN: 0-8053-6870-1
  45.  
  46. Excellent descriptions of all of the various kinds of computer
  47. documentation, and what the requirements are for each kind; very
  48. process-oriented, with good sections on organizing a project, creating a
  49. manual, using graphics, developing an index, revisions and rewriting,
  50. usability testing, how to be a good reviewer, and how to develop a style
  51. sheet.
  52.  
  53. _Handbook of Technical Writing_, Brusaw/Alred/Oliu, St. Martin's Press,
  54.                                  NYC, 1987, ISBN: 0-312-35810-5
  55.  
  56. A dictionary of terms you'll encounter in technical writing with a
  57. description of what each means to the process.
  58.  
  59. _Elements of Style_, Strunk and White
  60. _Chicago Manual of Style_
  61.  
  62. These are two of the best style guides ever written. I don't have the
  63. publisher or ISBN's here, but you can find them in any good public
  64. library reference section and get the particulars.
  65.  
  66. These should at least get you started. I'm sure there are others just as 
  67. useful or better, these happen to be the ones I'm familiar with.
  68.  
  69. Good luck.
  70. <-------------------------------^------------------------------------->
  71. |  Len Olszewski                |  "Writing is easy. All you do is    |
  72. |  Technical Writer             |   stare at a blank sheet of paper   |
  73. |  saslpo@unx.sas.com           |   until the drops of blood form on  |
  74. | "Have cursor, will curse."    |   your forehead." - Gene Fowler     |
  75. |---------------------------------------------------------------------|
  76. | Opinions this ludicrous are mine. Reasonable opinions will cost you.|
  77. <-------------------------------v------------------------------------->
  78.