home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / editor / gal210a1.arc / STYLE.GHP < prev   
Text File  |  1988-08-22  |  13KB  |  320 lines
  1. Correction Symbols
  2. Diction
  3. Punctuation
  4. Source Citation
  5. Technical Writing
  6. Books on Style
  7.  
  8. :Diction
  9.  
  10.            Proper words in proper places, make
  11.            the true definition of a style.
  12.                                         --Swift
  13.  
  14.   Never use a long word where a short word will do. An
  15. accomplished writer can have a large vocabulary without
  16. always using large words.  Speak directly, choosing the right
  17. word for the task.  Avoid unnecessary jargon.
  18. ::
  19.  
  20. 1. Use specific concrete terms.
  21.  
  22. Vague:     A certain nobleman appears on the scene.  
  23. Concrete:  Fortinbras returns from Poland.
  24.  
  25. Vague:     Professor Max is a tough grader.
  26. Concrete:  Professor Max regularly awards more F's than A's
  27.    and more D's than B's.
  28.  
  29. ::
  30.  
  31. 2. Avoid jargon.  Each profession has its necessary
  32. technical vocabulary, but choose the more common term when
  33. it is available.
  34.  
  35. Jargon:     When the keyboard locks up, do a cold boot.
  36.  
  37. Ordinary
  38. Language:   When the keyboard locks up, restart the
  39.    computer with the off/on switch.
  40. ::
  41.  
  42. 3. Avoid archaic, stilted, and overly formal diction.  Don't
  43. talk like a bureaucrat, a carpet-bag politician, or other
  44. stuffed shirt.
  45.  
  46. Stilted:   The means whereby I earn extra cash...
  47. Direct:    My parttime job...
  48.  
  49. Stilted:   Objective consideration of the phenomena
  50.    compelled the conclusion that the concentration of
  51.    sucrose had rendered the solution unpotable.
  52. Direct:    The coffee was so sweet I couldn't drink it.
  53. :
  54. :Punctuation
  55.                             Periods
  56.  
  57.     The period which ends a sentence ordinarily
  58. falls within the a quotation mark.
  59.  
  60. Example:  Fred said, "Don't give up the ship."
  61.  
  62.      The period follows the parenthesis when used within a
  63. sentence (but see the next sentence).  (When the entire
  64. sentence is in parenthesis then so is the period.)
  65.  
  66. ::
  67.                            Commas
  68. 1. Use commas to separate all the items in a series.
  69.    Ex: We ate peaches, pears, and apples.
  70. 2. Use commas before coordinating conjunctions that join
  71. independent clauses.
  72.    Ex: Jane usually pitches, and Fred catches every game,
  73.    but I have to stay in the outfield.
  74. 3. Place a comma after long phrases or clauses preceding the
  75. main clause. 
  76.    Ex: Without giving a second thought to his platter of
  77.    chicken enchiladas and refried beans, Jose ran off.
  78. 4. Place commas around appositives and other parenthetical
  79. elements.  Ex: John, long-ball hitter, bats fourth.
  80.                          Apostrophes
  81. 1. Use an apostrophe and an  s  to form the possesssive of a
  82. single noun.
  83.    Ex: a dog's tail, the boss's desk, Miss Jones's lifestyle
  84. 2. Use only the apostrophe to form the possessive of a
  85. plural noun ending in s.
  86.    Ex: a players' loss, the cats' meal, the Joneses' house
  87. 3. You can for the plurals of letters with apostrophes, but
  88. not of abbreviations or numbers.
  89.    Ex: p's and q's, 1800s and 1900s, SATs, GMATs, and GREs
  90. 4. Contractions require the apostrophe, but in semi-formal
  91. writing it is usually better the write out the words.
  92.    Ex: it is for it's, had not for hadn't
  93.                  Quotations and Underlining
  94. 1. Prose:  Use quotation marks when a direct quote is less
  95. than four typed lines.
  96.    Ex:  Wordsworth claims that Poetry "takes its origin from
  97. emotion recollected in tranquility."
  98. 2. Poetry: Quote one or two lines of poetry in quotation
  99. marks as part of your text, dividing the lines with a slash.
  100.    Ex: Dickenson begins, "A Spider sewed at Night / Without
  101.    a Light."
  102. 3. Indent longer quotations, omitting quotation marks.
  103. 4. Use quotation marks for titles of works published within
  104. larger works.  Underline titles of works published under
  105. separate cover.  Underline the titles of plays.
  106.    Ex: He assigned _Richard _III.  Read "Percieving Shape
  107. from Shading" in the August issue of _Scientific _American.
  108. :
  109. :Correction Symbols
  110.  
  111.     Here are symbols and abbreviations that your instructor
  112. might mark on your paper.  For each, an example problem is
  113. shown in parentheses, followed by the correction.
  114.  
  115. ab      abbreviation  (Honolulu, HA)
  116.                        Honolulu, HI
  117. adj     adjective  (He was real sick.)
  118.                     He was really sick.
  119. adv     adverb (Hopefully, he smiled.)
  120.                 I hope he smiled.
  121. ant     antecedent (No one likes their own voice.)
  122.                     No one likes her own voice.
  123.  
  124. agr     verb agreement (He is one of the many who runs.)
  125.                         He is one of the many who run.
  126. amb     ambiguous (She only knows this.)
  127.             Only she knows this. -or-  She knows only this.
  128. awk     awkward expression (Either she or I am going.)
  129.                    Either she is going or I am going.
  130. cap     capitalize (He saw president carter and pope Paul.)
  131.                     He saw President Carter and Pope Paul.
  132. cst     sent. construction (The reason I lie is because...)
  133.                             I lie because...
  134. d       diction (The presidential candidates were groovy.)
  135.                The presidential candidates were exceptional.
  136.  
  137. dm      dangling modifier  (Being drunk, the dog led.)
  138.                  Being drunk, Clyde let the dog lead.
  139. frag    sentence fragment  (If John saw it, and Jim agreed.)
  140.          If John saw it, and Jim agreed, then it was a UFO.
  141. lc      lower case (The bear was BIG.)
  142.                     The bear was big.
  143. mm      misplaced modifier (She dreams of skating in class.)
  144.                             In class she dreams of skating.
  145. //      parallel (Ann is a hitter, and can pitch and run.)
  146.                   Ann hits, pitches, and runs well.
  147. p       punctuation (Ann said; "Yes I have no bananas".)
  148.                      Ann said, "Yes, I have no bananas."
  149. pass    passive verb (Eating is an activity ejoyed by Al.)
  150.                       Al likes to eat.
  151. run-on  run-on sentence  (The metal was hot it glowed.)
  152.                           The metal was hot; it glowed.
  153. #       space (The player had a bigfoot.)
  154.                The player had a big foot.
  155. shift   in tense/person (The bank said that they will agree.)
  156.                         The bank said that it would agree.
  157. sp      spelling (Their is an odd symetry to this cemetary.)
  158.                  There is an odd symmetry to this cemetery.
  159. thesis  State your thesis in the first paragraph of an essay.
  160. topic   Make the first sentence of the paragraph the topic
  161.         sentence.
  162. tr      transpose (She spaeks oto lsowly.)
  163.                    She speaks too slowly.
  164. und     underline (Jane starred in "As You Like It.")
  165.                 Jane starred in _As _You _Like _It.
  166. vb      wrong verb form (Several days has went bye.)
  167.                          Several days have gone bye.
  168. wordy   wordy (It has come to my attention that your car...)
  169.                                                 Your car...
  170. ww      wrong word (I represented his cowardly temerity.)
  171.                     I resented his cowardly reluctance.
  172. :
  173.  
  174. :Technical Writing
  175.  
  176. 1. Technical Writing is writing with a purpose.  Analyze your
  177. audience.  Determine what information they need, and devise
  178. strategies to help them assimilate that information as
  179. efficiently as possible.  An effective document will lighten
  180. the load on its readers.
  181.  
  182. 2. Be technically accurate.  Check your work at each step.
  183. Consult experts.  Have your finished document read and
  184. reread.  Test the document by giving it to readers new to the
  185. subject.
  186. ::
  187.  
  188. 3. Take utmost care in the first pages of a document.  It is
  189. easy for a writer to pass over underlying concepts, and
  190. initial assumptions that readers must master before they can
  191. understand anything else.
  192.  
  193. 4. Provide numerous examples.  Concrete examples can enliven
  194. dead abstractions and render tedious explanations readable.
  195. Begin with simple examples.  For instance, a typical first
  196. computer program prints "Hello world" on the screen.  Lead up
  197. to more complex problems and considerations.  Take your
  198. reader with you.
  199. ::
  200. 5. Tabulate, list, and number the steps, whenever writing
  201. instructions that require action.  Divide complex procedures
  202. into sub-procedures and give each a title.  Put instructions
  203. in the active, imperative voice (the command form).
  204.    Ex: When the food is ready (see "Preparing Food" above)
  205.        you may begin packing the jars as follows:
  206.                      Canning Fruits
  207.         1) Pack the jars firmly without crushing the fruit.
  208.         2) Fill the jars with sugar sirup to within 1/2 inch
  209.            of the top.
  210.         3) Expell any trapped air using a long thin spatula.
  211.         4) Carefully wipe off the top of the jar.
  212.         5) Using manufacturer's procedures seal the lids.
  213. 6. It is your ethical (and often legal) responsibility to
  214. anticipate dangers and provide eyecatching notes and
  215. warnings.  It is good style to insert advice, and helpful
  216. hints.  If you know what helped you learn a concept or master
  217. a skill, be sure to pass the tip on to your reader.
  218.    Ex:
  219.       IMPORTANT: When canning at high altitudes add 1/2
  220.                  pound of pressure for every 1,000 feet.
  221.  
  222.   |                        WARNING                         |
  223.   |  The boiling water bath process is not suitable for    |
  224.   | canning meats, fish, and nonacid fruits and vegatables |
  225. ::
  226.  
  227. 7. Illustrate copiously.  Provide tables, charts, diagrams,
  228. and simple line drawings.  Where appropriate use shading to
  229. give a crisp sense of three dimensionality.  (Mechanical
  230. drawings are often as difficult as complex prose and photos
  231. usually do not reproduce well.)
  232. :
  233.  
  234. :Source Citation
  235.  
  236.                           Plagiarism
  237.  
  238.    To plagiarize is to use other people's words or ideas
  239. without acknowledging them.  You are guilty of plagiarism
  240. whenever you try to pass off as your own, something another
  241. said or wrote.   You must acknowledge borrowings whether the
  242. source is a roommate or an encyclopedia article.
  243. ::
  244.                     Parenthetical Citations
  245.    Give credit to your sources and cite them parenthetically
  246. in the text.
  247.  
  248. Ex:   According to Robert M. Durling, Dante's Hell is a giant
  249.     projection of the human body. ("Deceit and Digestion in
  250.     the Belly of Hell," in _Allegory _and _Representation,
  251.     ed. Stephen J. Greenblatt, 61).
  252.  
  253. Ex:   _Time says that Ronstadt's _Canciones _de _Mi _Padre is
  254.     "headed for platinum" (July 11, 1988, p. 73).
  255. ::
  256.                          List of Works
  257.    Include a list of works cited (a bibliography) at the end
  258. of your paper if you use several sources or if your
  259. instructor requests it.   Then when you cite a work in you
  260. text you can keep the parenthetical reference brief.
  261.  
  262. Ex.   Particularly, the Malebolge associates the belly with
  263.     Fraud (Durling, 65).
  264. Ex.   Ramachandran supposes that we assume only one light
  265.     source "because our brains evolved in a solar system that
  266.     has only one sun" (76).
  267. Ex.    The drought will cause meat prices to fall until
  268.     November and the rise sharply (_Time, 44).
  269.                       Indented Passages
  270.    When quoting a passage long enough to indent, place the
  271. citation outside of the quoted material.
  272.  
  273. Ex.  The speaker exhibits the synesthesia of a visionary:
  274.  
  275.            How the Chimney-sweepers cry
  276.            Every blackning Church appalls,
  277.            And the hapless Soldiers sigh,
  278.            Runs in blood down Palace walls
  279.                                 (Blake, 27)
  280. :
  281. :Books on Style
  282.  
  283.                        Recommended Texts
  284.  
  285.      Students should always have at hand a desk-sized
  286. dictionary, such as _Webster's _New _Collegiate _Dictionary.
  287. (If you can afford it, the new _Random _House _Dictionary is
  288. readable and up-to-date.) In addition, we recommend that you
  289. consult the following works on questions of style.
  290.  
  291.  
  292. Bly, Robert W. and Gary Blake.  _Technical _Writing:
  293.      _Structure, _Standards, _and _Style.  New York:
  294.      McGraw_Hill (latest edition).
  295.  
  296. _Chicago _Manual _of _Style.  Chicago: Univ. of Chicago Press
  297.      (latest edition).
  298.  
  299. Gibaldi, Joseph and Walter S. Achtert.  _MLA _Handbook _for
  300.      _Writers _of _Research _Papers.  New York: The Modern
  301.      Langauge Association of America (lastest edition).
  302.  
  303. Lanham, Richard A.  _Revising _Prose.  New York: Scribner's,
  304.      1979.
  305.  
  306. _____________.  _Style: _An _Anti-Textbook.  New Haven:
  307.      Yale, 1974.
  308.  
  309. Prentice-Hall, Inc.  _Words _Into _Type.  Englewood Cliffs,
  310.      New Jersey: Prentice-Hall (latest edition).
  311.  
  312. Strunk, William, Jr.  and E. B. White.  _The _Elements _of
  313. _Style.  New York: Macmillan (latest edition).
  314.  
  315. Turabian, Kate L.  _A _Manual _for _Writers.  Chicago: Univ.
  316.      of Chicago Press (latest edition).
  317.  
  318. :
  319.  
  320.