Topics: Editing Tech Pubs for Style 7 July 2009 (472_090707_Diction.doc) Diction notes Review of research Diction Anthony, L. 2006. Developing a freeware, multiplatform corpus analysis toolkit for the technical writing classroom. IEEE Transactions on Professional Communication 49 (3): 275-286. [E-reserves] Paulson, E, J. Alexander, and S. Armstrong. 2007. Peer review re-viewed: Investigating the juxtaposition of composition students' eye movements and peer-review process. Research in the Teaching of English 41 (3): 304-335. [E-reserves] Plain English Byrne, Don. 2008. Writing government policies and procedures in plain language. Business Communication Quarterly 71(1): 88-92. Jacobson, R. 2006. Plain language in the federal government. The Editorial Eye 29 (7): 1-4. [E-reserves] Plain language: Improving communications from the Federal Government to the public. n.d. PlainLanguage.gov. 5 July 2007. Provides a link to plain language resources specifically for writers and editors. Rudd, Rima, Kimberly Kaphingst, Tayla Colton, John Gregoire, and James Hyde. 2004. Rewriting public health information in plain language. Journal of Health Communication 9 (3): 195-206. Schriver, Karen. 1997. Dynamics in document design. New York: John Wiley & Sons. Shriver provides an overview of the development of the plain language movement in the UK, the US, Canada, and Australia (26-32). Thrush, Emily. 2001. Plain English? A study of plain English vocabulary and international audiences. Technical Communication 48 (3): 289-296. Simplified Technical English Boeing provides the following definition of Simplified Technical English: The main characteristics of the Simplified Technical English standard are Simplified grammar and style rules. A limited set of approved vocabulary with restricted meanings. A thesaurus of frequently used terms and suggested alternatives. Guidelines for adding new technical words to the approved vocabulary. The objective of Simplified Technical English is clear, unambiguous writing. Developed primarily for non-native English speakers, it is also known to improve the readability of maintenance text for native speakers. ASD Simplified Technical English does not attempt to Topics: Editing Tech Pubs for Style 30 June 2009 Page 2 define English grammar or prescribe correct English. It does attempt to limit the range of English, and many of its rules are recommendations found in technical writing textbooks. For example, SE requires writers to Use the active voice. Use articles wherever possible. Use simple verb tenses. Use language consistently. Avoid lengthy compound words. Use relatively short sentences. Controlled English for global documentation. n.d. Technical English Services. Dow Douglas. 25 October 2007. Simplified Technical English: What’s in it for us? [ppt] STC India Annual Conference. Fonesca, David. 2006. How simple is Simplified Technical English? Intercom 53 (2): 20-22. Lester, Larry. 2006. Simplified Technical English: STC should take the lead. Intercom 53 (7): 22-23. Available only to STC members. Thomas, Margaret, Gloria Jaffe, J. Peter Kincaid, and Yvette Stees. 1992. Learning to use Simplified English: A preliminary study, Technical Communication 39 (1): 69-73. STE websites Aerospace and Defense Simplified Technical English Maintenance Group (STEMG) Boeing's Phantom Works: Simplified English Checker Simplified english-aecma.org European Association of Aerospace Industries (AECMA) Simplified English rules and vocabulary. n.d. Scribd Simplified Technical English – ASD-STE100 (Shufra) Smart Communications' Simplified English and Controlled English Userlab Inc.'s Simplified English Topics: Editing Tech Pubs for Style 30 June 2009 Page 3 Standards American National Standards Institute (ANSI) International Telecommunication Union (ITU) International Organization for Standardization (ISO) National Institute of Standards and Technology (NIST) Jones’ Technical Writing Style The following vocabulary and list of writing styles were taken from Chapters 5–6 of Jones’ Technical Writing Style. All page references are to his text. Vocabulary You are responsible for the following vocabulary: Diction – four levels are formal, informal, colloquial, and slang appropriateness – clarity – conciseness – concreteness – consistency – simplicity – sincerity – Connotation – Denotation – Homonyms – Homographs – Homophones – Synonyms – Nounce words – Expletives – Solecisms – Literary style – alliteration – anthropomorphizing – assonance/consonance – elegancies and literarisms – Topics: Editing Tech Pubs for Style 30 June 2009 Page 4 figures of speech – similes, metaphors, personification, hyperbole, and understatement Euphemisms – Dysphemisms – Abbreviations – acronyms – TLA, TLAs, ETLA, SFLA, YABA (Foldoc) As of 2003-11-10, Foldoc gave expansions for 1218 out of the 26^3 = 17576 possible TLAs. initialisms – A SQL server vs. an SQL server? By the way, the correct pronunciation of SQL is a contentious issue within the database community. In their SQL standard, the American National Standards Institute declared that the official pronunciation is "es queue el." However, many database professionals have taken to the slang pronunciation "sequel." The choice is yours. (SQL Fundamentals, About.com) SQL was developed at IBM by Andrew Richardson, Donald C. Messerly and Raymond F. Boyce in the early 1970s. This version, initially called SEQUEL, was designed to manipulate and retrieve data stored in IBM's original relational database product, System R. (Wikipedia) Common diction faults Jones identifies the following common diction faults: archaic words/dialect/colloquialisms – bloopers/vulgarism/taboo words/barbarisms – catchword/catchphrase/vogue words – clichés – clipped words/contractions – commonly confused words/confusibles/suggestibles – double negatives foreign words and phrases/Latin abbreviations – idioms – ‘izing”/nominalizations/verbizing/-wise words – logic trap words/meaningless words/totality words/vagueness/wooliness – legal terms/overuse of prepositional phrases modifiers/noun phrases/noun strings – negative words and phrases/negative instructions – neologisms/nonsense words – redundancy/repetition/tautology/expletives – sexist and discriminatory languge – Topics: Editing Tech Pubs for Style 30 June 2009 Page 5 solecisms/improprieties – Specialized languages Jones identifies the following specialize languages: jargon – occupational slang, professional/technical terminology, technical metaphors, buzzwords, doublespeak, abbreviations, and ex-jargon slang – cant and argot – doublespeak – euphemism, jargon, gobbledygook (or bureaucratese), and inflated language tech speak – technobabble and computerese – shop talk – Quiz You have 15 minutes for this quiz. You may use your texts; however, if you do quote, paraphrase, or summarize information from any of your texts, please cite the source (title and page parenthetically). Please write as much as you can as quickly as you can. 1. Distinguish between plain language and simplified technical English. How are they similar? How are they different? 2. What is AntConc? What appear to be its greatest benefits and drawbacks? 3. What role does diction/vocabulary play in readability formulas? Exercises—Plain language The following examples are taken from the PlainLanguage.gov website. EXAMPLE 1 Before Right of use means any authorization issued under this part that allows use of Outer Continental Shelf lands. Your revision After Right of use means any authorization under this part to use Outer Continental Shelf lands. Topics: Editing Tech Pubs for Style 30 June 2009 Page 6 EXAMPLE 2 Before This regulation governs disaster assistance for services to prevent hardship caused by fire, flood, or acts of nature that are not provided by FEMA or the Red Cross. Revision After This regulation governs disaster assistance that (a) consists of services to prevent hardship caused by fire, flood, or acts of nature; and (b) is furnished by a provider other than FEMA or the Red Cross. EXAMPLE 3 Before This rule proposes the Spring/Summer subsistence harvest regulations in Alaska for migratory birds that expire on August 31, 2003. Revision After This rule proposes the Spring/Summer subsistence harvest regulations for migratory birds in Alaska. The regulations will expire on August 31, 2003 Exercise—E-prime Robert Wilson has written a brief primer on E-prime, which encourages us to eliminate existential uses of the verb be (modifying those uses of the verb be in sentences of the pattern SubjectVerb-Complement). Wilson, Robert Anton. n.d. Toward understanding E-prime. NoBeliefs.com <http://www.nobeliefs.com/eprime.htm> 14 October 2005. Note how I have replaced be in the following sentences: The result of such editing or rewriting is almost always a longer and livelier sentence. Such editing or rewriting typically results in a longer and livelier sentence. Buffy is a student. Buffy has attended MSU since 2002. Biff is sleepy. Biff can barely stay awake. Do not confuse the existential use of be with the use of be as an auxiliary verb in progressive and passive verb phrases. Topics: Editing Tech Pubs for Style 30 June 2009 Page 7 Buffy is taking three courses this semester. Biff was diagnosed with narcolepsy. With E-prime, you are primarily concerned with the various forms of the verb be; however, I would encourage you to extend your concern to all linking verbs—those which produce the following sentence pattern: S V C. The most common linking verbs are be seem look become appear taste sound feel smell Advocates of E-prime accept the substitution of appears for be as in the following example: The bicycle is red. The bicycle appears red. But most of us would claim that the speaker or writer of those two sentences has very different purposes for using one rather than the other—that the sentences are not synonymous in locution, illocution, or perlocution. Following the examples above, revise the following sentences: 1. Biff is a student. 2. Jay was giddy. 3. The frog is green. 4. The meat tastes salty. 5. Buffy is a botanist. 6. What you see is what you get. 7. Cheating seems wrong. 8. Lutefisk is my favorite food. D2L small-group assignment Please complete the following tasks: 1. TWS, Chapter 5, Exercise 7, page 114. Read the following two paragraphs concerning the presentation program PowerPoint. characterize the appropriateness of the word choices and the conciseness of the prose: Whether presentations help you deliver company results to a shareholders’ meeting or report sales figures at a hastily scheduled business meeting, they play a major role in how business people communicate. Microsoft PowerPoint for Windows 95, the leader in presentation graphics software, has all the tools you’ll need to put together professional, compelling presentations quickly and easily. Topics: Editing Tech Pubs for Style 30 June 2009 Page 8 Microsoft PowerPoint for Windows 95 Step by Step is a comprehensive tutorial that shows you how to use PowerPoint to create professional looking presentations. Working through this book you’ll learn about the different presentation materials PowerPoint helps you create: slides, overheads, audience handouts, presentation outlines, speaker’s notes, and electronic presentations that show on your computer. You’ll discover the basic building blocks that make up dynamic slides, including eyecatching clip art, easy-to-use text tools that let you create and format text, drawing tools the [sic] help you create interesting shapes and effects, and special tools that help you import information from other sources, such as charts, graphs, tables, picture, sounds, and movies. This book also teaches you how to find the help you need from PowerPoint’s useful aids such as online Help, tips, and wizards. Response: 2. TWS, Chapter 6, Exercise 12, pages 140-141 Highlight (in yellow) your characterization of the word choices; then, complete the justification for your choice. Example 1 – jargon, slang, shoptalk, argot, or ? because Example 2 – jargon, slang, shoptalk, argot, or ? because Example 3 – jargon, slang, shoptalk, argot, or ? because Example 4 – jargon, slang, shoptalk, argot, or ? because Example 5 – jargon, slang, shoptalk, argot, or ? because