Successfully reported this slideshow.
Your SlideShare is downloading. ×

Technical Style Workshop Part 1

Ad
Ad
Ad
Ad
Ad
Ad
Ad
Ad
Ad
Ad
Ad
Loading in …3
×

Check these out next

1 of 30 Ad

Technical Style Workshop Part 1

Download to read offline

Part 1 of a 2-day workshop to introduce style in technical communication. Presented to beginning students of technical communication on December 1, 2009 at Kyung Hee University in Suwon, South Korea.

Part 1 of a 2-day workshop to introduce style in technical communication. Presented to beginning students of technical communication on December 1, 2009 at Kyung Hee University in Suwon, South Korea.

Advertisement
Advertisement

More Related Content

Slideshows for you (20)

Advertisement

Recently uploaded (20)

Advertisement

Technical Style Workshop Part 1

  1. 1. Technical Style<br />A 2-day workshop presented by Edwin Hollon<br />December 1 & 8, 2009<br />Kyung Hee University – Suwon, South Korea<br />
  2. 2. Introduction<br />What is style in technical communication?<br />How we try to reach our audience<br />The tone we use<br />The conventions we follow<br />The grammatical choices we make<br />
  3. 3. The Rhetorical Situation<br />Decisions about “style” and “correctness” are determined by the rhetorical situation<br />Occasion (when/where)<br />Context<br />Message (style, tone, delivery method)<br />Audience (who)<br />Purpose (why/what)<br />
  4. 4. Exercise 1<br />Match the rhetorical situation to the appropriate type of message.<br />
  5. 5. Clarity<br />As writers, we attempt to tell our audience a story. We must tell our readers who the characters are and what the story is about.<br />What are the subjects of these sentences?<br />
  6. 6. Clarity<br />Principle 1: To make your writing clear, tell stories about characters and their actions.<br />There is opposition among many voters to nuclear power plants based on a belief of their threat to human health.<br />Many voters oppose nuclear power plants because they believe that such plants threaten human health.<br />Make main characters your subjects and describe their actions with verbs.<br />
  7. 7. Clarity<br />Principle 2: Use verbs for important actions.<br />Where are the actions in these sentences?<br />
  8. 8. Clarity<br />Nominalization:When we change verbs and adjectives into nouns, we create an abstraction called a nominalization.<br />A walk through the woods was taking place by Little Red Riding Hood.<br /> to walk (verb) &gt; a walk (noun)<br />The wolf’s jump from behind the tree occurred.<br />to jump (verb) &gt; the wolf’s jump (noun)<br />
  9. 9. Exercise 2<br />Which are nominalizations and which are verbs?<br />What are the verb forms of the nominalizations?<br />Change nominalizations to verbs<br />
  10. 10. Exercise 3<br />Where is the action? Is the action in a verb?<br />There is no need for further study of this problem.<br />“there is” does not describe any action<br />The intention of the committee is to audit the records.<br />the action is a nominalization (“intention”)<br />The agency conducted an investigation into the matter.<br />an empty verb (“conducted”) is used with a nominalization (“investigation”)<br />Replace empty verbs and nominalizations with active verbs<br />
  11. 11. Review: Clarity<br />Readers prefer:<br />Characters as subjects<br />Action in verbs<br />Concrete descriptions (verbs) rather than abstractions (nominalizations)<br />Q: How can I revise my sentences for clarity?<br />A: With a simple three-step process:<br />Diagnose<br />Analyze<br />Revise<br />
  12. 12. Review: Clarity<br />Diagnose<br />The outsourcing of high-tech work by corporations means the loss of jobs for many American workers.<br />Underline the first seven or eight words of the sentence.<br />Does the subject include an abstract noun (such as nominalization)?<br />Does it take more than six or seven words to reach the verb (the “real” action)?<br />
  13. 13. Review: Clarity<br />Analyze<br />The outsourcing of high-tech work by corporations means the loss of jobs for many American workers.<br />Decide who the main characters are (preferably real people or groups of people).<br />Look for the actions performed by those characters (especially action in a nominalization).<br />
  14. 14. Review: Clarity<br />Revise<br />The outsourcing of high-tech work by corporations means the loss of jobs for many American workers.<br />Change nominalizations to verbs.<br />Make characters the subjects of the verbs.<br />If necessary, use conjunctions to link sentence clauses (because, if, when, although, why, how, whether, etc).<br />Many American workers are losing their jobs, because corporations are outsourcing their high-tech work.<br />
  15. 15. Break<br />15 minutes<br />
  16. 16. Characters<br />Readers want characters as subjects. They have the most difficulty with sentences that contain no characters.<br />A decision was made in favor of doing a study of the structural integrity of the bridge. <br />Who made the decision?<br />I did?<br />We did?<br />They did?<br />
  17. 17. Characters<br />Principle 3: Write in the active voice to describe characters and actions.<br />Active: Subject (a person) + verb + object:<br />I lost the money<br />Passive: Subject (object or goal)+ “to be” verb in past tense + prepositional phrase (character or maybe missing entirely)<br />The money was lost [by me].<br />
  18. 18. Exercise 4<br />What are the passive verbs in these sentences?<br />Success is achieved when valuable skills are learned.<br />Different levels of stress are evident when the structure is examined closely.<br />Change passive verbs to active verbs<br />
  19. 19. Exercise 5<br />Rewrite the sentences by changing the passive verbs to active and inventing characters.<br />Success is achieved when valuable skills are learned.<br />Students who learn valuable skills will achieve success.<br />Multiple levels of stress were evident when the structure was examined closely.<br />When we examined the structure closely, we found evidence of multiple levels of stress.<br />Invent characters if necessary (and if known)<br />
  20. 20. Cohesion & Coherence<br />Cohesion: “a sense of flow;” the way sentences fit together (how one sentence ends and the next begins)<br />at the sentence level (sentence + sentence)<br />Coherence: “fitting together;” the way a series of sentences or paragraphs work together logically<br />at the paragraph, section, chapter, or document level (multiple sentences, multiple paragraphs, etc.)<br />When our writing is both cohesive and coherent, it flows naturally and makes sense to our readers.<br />
  21. 21. Cohesion<br />Principle 4: Begin sentences with familiar information.<br />Principle 5: End sentences with new information.<br />Old information first (learning)<br />New information last (applying)<br />Old/New pattern<br />
  22. 22. Cohesion<br />Begin sentences with information familiar to your readers.<br />Information from the previous sentence is “familiar.”<br />General knowledge about the subject is “familiar.”<br />End sentences with information that is unexpected or cannot be anticipated.<br />Scientists have raised some astonishing questions about the universe by studying black holes in space. Black holes are created when dead stars collapse into a point no larger than a marble. <br />
  23. 23. Exercise 6<br />Rearrange the paragraph so that it follows the old/new pattern:<br />By compressing so much matter into such a small volume, the fabric of space is changed in puzzling ways. Black holes are created when dead stars collapse into a point no larger than a marble. Scientists have raised some astonishing questions about the universe by studying black holes in space.<br />3<br />2<br />1<br />
  24. 24. Coherence<br />Readers expect information in a paragraph to be related. Our writing should show a logical connection between topics.<br />If cohesion is like two Lego pieces fitting together, then coherence is like an entire structure made of Lego pieces.<br />
  25. 25. Coherence<br />Coherence is based on related strings of topics in a paragraph.<br />Sayner, Wisconsin is the snowmobile capital of the world. The buzzing of snowmobile engines fills the air and their tanklike tracks crisscross the snow. The snow reminds me of Mom’s mashed potatoes, covered with furrows I would draw with my fork. Her mashed potatoes usually make me sick—that’s why I play with them. I like to make a hole in the middle of the potatoes and fill it with melted butter. This behavior has caused long discussions between me and my therapist.<br />v<br />
  26. 26. Coherence<br />To create coherence, we must:<br />Make the subjects of our sentences related.*<br />Make the sentences share a common theme or idea.<br />Make the whole paragraph focus on a single point (“thesis” statement and supporting sentences).<br />* Before, I said coherence is based on strings of topics. Subjects and topics are not always the same thing, but for clarity, they should be. If you make characters the subjects of your sentences, then those subjects will be your topics.<br />
  27. 27. Review: Cohesion & Coherence<br />Cohesion is:<br />The way two sentences fit together (two Lego blocks)<br />Based on the old/new pattern<br />Based on what is familiar to your audience<br />Coherence is:<br />The way multiple sentences fit together (a Lego castle)<br />Based on topic strings (use characters as subjects!)<br />Focused on a single topic<br />Q: How can I revise my sentences for cohesion & coherence?<br />A: With a simple three-step process:<br />Diagnose<br />Analyze<br />Revise<br />
  28. 28. Review: Cohesion & Coherence<br />Diagnose<br />The particular ideas toward the beginning of sentences define what a passage is “about” for a reader. Moving through a paragraph from a coherent point of view is made possible by a sequence of topics that make up a limited set of related ideas. A seeming absence of context for each sentence is one result of making random topic shifts. Feelings of dislocation, orientation, and lack of focus in a passage occur when that happens.<br />Underline the first seven or eight words of the sentence.<br />If you can, underline the first five or six words of every clause (main & dependent clauses).<br />
  29. 29. Review: Cohesion & Coherence<br />Analyze<br />The particular ideas toward the beginning of sentences define what a passage is “about” for a reader. Moving through a paragraph from a coherent point of view is made possible by a sequence of topics that make up a limited set of related ideas. A seeming absence of context for each sentence is one result of making random topic shifts. Feelings of dislocation, orientation, and lack of focus in a passage occur when that happens<br />Do the underlined words make up a relatively small set of ideas?<br />Do those words name the most important characters?<br />What are the main topics and characters?<br />
  30. 30. Review: Clarity<br />Revise<br />In most (not necessarily all) of the sentences, use subjects to name the topics.<br />Put the subjects close to the beginning of the sentences (close to the beginning of main and dependent clauses)<br />Readers look for consistent topics of sentences to tell them what a whole passage is “about.” If they feel that its sequence of topics focuses on a limited set of related topics, then they will feel they are moving through that passage from a coherent point of view. But if topics seem to shift randomly, then readers will begin each sentence feeling dislocated and disoriented and the passage will seem out of focus.<br />

Editor's Notes

  • English sentence structure = SVO (subject + verb + object).
  • English sentence structure = SVO (subject + verb + object).

×