home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #18 / NN_1992_18.iso / spool / misc / writing / 2533 < prev    next >
Encoding:
Text File  |  1992-08-12  |  2.4 KB  |  50 lines
  1. Newsgroups: misc.writing
  2. Path: sparky!uunet!decwrl!world!ggray
  3. From: ggray@world.std.com (Gary P Gray)
  4. Subject: Re: "Wow! You're a writer?"
  5. Message-ID: <BswJE4.716@world.std.com>
  6. Organization: The World Public Access UNIX, Brookline, MA
  7. References: <BsuMty.JC4@well.sf.ca.us> <s0067284.713623707@ursa> <BsvK6y.341@unx.sas.com>
  8. Date: Thu, 13 Aug 1992 03:08:26 GMT
  9. Lines: 39
  10.  
  11. It is written in <BsvK6y.341@unx.sas.com> that saslpo@stevens.unx.sas.com (Len Olszewski) said:
  12. >
  13. >On the other hand, when I tell people I'm a writer, and elaborate by 
  14. >explaining that I write manuals for computer software, nobody ever tells 
  15. >me they liked what I've written. In fact, very few people have ever read 
  16. >what I've written, and they still get mad at *me* for bad computer 
  17. >manuals that OTHER people have written. Many of them begin to berate me, 
  18. >though I never let that go very far before responding in my own defense.
  19.  
  20. Ahh yes, there were times when I was sitting in the computer lab at school
  21. when there were CS majors mumbling about how crummy this or that manual was
  22. (very thick, very large Motif manuals for example) looking for someone to
  23. blame, and possibly hurl the useless hunk of printed matter at... I would
  24. just sorta keep quiet and not mention I was a tech writing major...
  25.  
  26. But of course, I have spent my own fair share of time swearing at poorly
  27. documented software. Doubly so, since if I had written it *I* would have
  28. gotten it right (or at least I keep telling myself that.)
  29.  
  30. Usually, however, the people I have talked to don't seem to blame me, but
  31. hope that I would be able do a better job than the "bozos" who had written
  32. the others. 
  33.  
  34. An interesting phenomina I have seen is that people seem to appreciate a
  35. writer more for doing something that he/she didn't have to do. I wrote a
  36. manual some time back for a Multi user role playing game that runs on the
  37. net (hopelessly in need of revision... someday).  I found that a *lot* of
  38. people, on seeing me online in these games, would thank me for writing it...
  39. much more than they would thank the programmers who wrote the actual code,
  40. it seems. Strange...  I guess when they don't expect clear documentation and
  41. get it, the really appreciate it.
  42.  
  43. Oh well, it's time for the nose to meet the grindstone. One more day in the
  44. fight against poor documentation...
  45. -- 
  46.  ---- WARNING!!! The above opinions may be HAZARDOUS or FATAL if swallowed ----
  47.             Gary Gray -- ggray@world.std.com
  48.                ?sdrawkcab gnihtyreve tog ev'uoy ekil leef reve
  49.  
  50.