home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / UFG_103.ZIP / USENET.STL < prev    next >
Text File  |  1989-07-08  |  5KB  |  112 lines
  1. From pacbell!ames!apple!rutgers!tut.cis.ohio-state.edu!purdue!spaf Sat Jul  8 08:34:44 PDT 1989
  2. Article 413 of news.announce.newusers:
  3. Path: hoptoad!pacbell!ames!apple!rutgers!tut.cis.ohio-state.edu!purdue!spaf
  4. >From: spaf@cs.purdue.EDU (Gene Spafford)
  5. Newsgroups: news.announce.newusers
  6. Subject: Hints on writing style for Usenet (Updated: 6 March 1989)
  7. Message-ID: <6958@medusa.cs.purdue.edu>
  8. Date: 20 Jun 89 04:27:34 GMT
  9. Expires: 18 Sep 89 04:27:33 GMT
  10. Organization: Dept. of Computer Sciences, Purdue Univ.
  11. Lines: 95
  12. Approved: spaf@cs.purdue.EDU
  13. Supersedes: <6750@medusa.cs.purdue.edu>
  14.  
  15. Original-from: ofut@gatech.edu (A. Jeff Offutt VI)
  16. [Most recent change: 6 March 1989 by spaf@cs.purdue.edu (Gene Spafford)]
  17.  
  18. I would like to take a moment to share some of my knowledge of writing
  19. style.  If you read the suggestions below, remember: it's easy to agree
  20. that they make sense but it's much harder to apply them.
  21.  
  22. References: 
  23.  Cunningham and Pearsall, "How to Write For the World of Work"
  24.  Strunk & White, "Elements of Style"
  25.  
  26. The above references are both excellent books.  Cunningham is a
  27. standard in tech writing classes and won an award for the best tech
  28. writing book from the Association for Teaching of Technical Writing.  I
  29. was lucky enough to take a class from him as an undergraduate.  Strunk
  30. is a standard in college composition classes.  Other ideas here come
  31. from my own experience on the net and hints from other people.
  32.  
  33. This is a "long article." The rest of it is simply a list of pointers.
  34.  
  35.                Writing style:
  36.  
  37.  * Write *below* the readers' reading level.  The avg. person in the US
  38.    reads at a 5th grade level (11 years of age). The avg. professional
  39.    reads at about the 12th grade level (18 years of age).
  40.  
  41.  * Keep paragraphs short and sweet.  Keep sentences shorter and sweeter. 
  42.    This means "concise," not cryptic.
  43.  
  44.  * White space is not wasted space -- it greatly improves clarity.
  45.    A blank line only adds a byte to the article length, so don't be
  46.    stingy if it will help make your meaning clearer.
  47.  
  48.  * Pick your words to have only *one* meaning.  Vagueness is considered 
  49.    artistic by literary critics.  We are not being literary here.
  50.  
  51.  * People can only grasp about seven things at once.  This means ideas in a
  52.    paragraph, major sections, etc..
  53.  
  54.  * Avoid abbreviations and acronyms, if possible, and define the ones
  55.    you use.
  56.  
  57.  * There are several variations on any one sentence.  A passive, questioning
  58.    or negative sentence takes longer to read.
  59.  
  60.  
  61.                Net style:
  62.  
  63.  * Subtlety is not communicated well in written form - especially over a 
  64.    computer.
  65.  
  66.  * The above applies to humor as well. (rec.humor, of course, not included.)
  67.  
  68.  * When being especially "flame-boyant", I find it helpful to go to the bathroom
  69.    before actually sending.  Then, I often change the tone considerably. :-)
  70.    Take a break before posting something in anger or that might hurt or
  71.    anger others.
  72.  
  73.  * Subject lines should be used very carefully.  How much time have you
  74.    wasted reading articles with a misleading subject line?  The "Subject:"
  75.    header line can be edited in all the various posting programs
  76.    (as can the "Distribution:", "Newsgroups:" and "Followup-To:" header
  77.    lines).
  78.  
  79.  * References need to be made.  When you answer mail, you have the original
  80.    message fresh in your mind.  When I receive your answer, I don't.
  81.  
  82.  * It's *much* easier to read a mixture of upper and lower case letters.
  83.  
  84.  * Leaving out articles (such as "the," "a," "an," etc.) for "brevity"
  85.    mangles the meaning of your sentences and takes longer to read. It saves
  86.    you time at the expense of your reader.
  87.  
  88.  * Be careful of contextual meanings of words. For instance, I used "articles" 
  89.    just now.  In the context of netnews, it has a different meaning than I 
  90.    intended.
  91.  
  92.  * Make an effort to spell words correctly.  Obvious misspellings are
  93.    jarring and distract the reader.  Every news posting program allows
  94.    you to edit your article before posting, and most systems have some
  95.    kind of spelling checker program that you can use on your article.
  96.  
  97.  * Remember - this is an international network.
  98.  
  99.  * Remember - your future employers may be reading your articles.
  100.  
  101. 'Nuff said.  
  102.  
  103. These suggestions are all easily supported by arguments and research.
  104. There's a lot more to say, but....
  105. -- 
  106. Gene Spafford
  107. NSF/Purdue/U of Florida  Software Engineering Research Center,
  108. Dept. of Computer Sciences, Purdue University, W. Lafayette IN 47907-2004
  109. Internet:  spaf@cs.purdue.edu    uucp:    ...!{decwrl,gatech,ucbvax}!purdue!spaf
  110.  
  111.  
  112.