Foreword to the Series |
|
xi | (2) |
Preface |
|
xiii | |
|
1 Understanding Technical Writing Style |
|
|
1 | (18) |
|
|
1 | (1) |
|
The Problem with Defining Style |
|
|
2 | (1) |
|
|
3 | (1) |
|
Style in Technical Writing |
|
|
3 | (4) |
|
The Domain of Technical Writing Style |
|
|
7 | (3) |
|
Why Technical Writing Is Often Ineffective |
|
|
10 | (1) |
|
Technical Writing as a Craft |
|
|
11 | (1) |
|
|
11 | (1) |
|
Case Study 1 Three Mile Island and Ineffective Communication |
|
|
12 | (2) |
|
Questions/Comments for Discussion |
|
|
14 | (1) |
|
|
14 | (3) |
|
|
17 | (2) |
|
2 Reflecting the Style of a Discourse Community |
|
|
19 | (23) |
|
|
19 | (1) |
|
What is a Discourse Community? |
|
|
20 | (2) |
|
How Does a Discourse Community Affect Style? |
|
|
22 | (3) |
|
Questions to Consider Before Writing to a Discourse Community |
|
|
25 | (1) |
|
Case Study 2 The Space Shuttle Challenger and Different Discourse Communities |
|
|
26 | (8) |
|
How Does Style Relate to Subject, Purpose, Scope, Audience, and Other Elements of Writing? |
|
|
34 | (4) |
|
|
38 | (1) |
|
Questions/Comments for Discussion |
|
|
38 | (1) |
|
|
39 | (1) |
|
|
40 | (2) |
|
3 Choosing an Appropriate Style |
|
|
42 | (20) |
|
|
42 | (1) |
|
|
43 | (1) |
|
Prescriptive and Descriptive Approaches to Style |
|
|
43 | (1) |
|
|
44 | (1) |
|
|
45 | (1) |
|
Appropriate and Inappropriate Styles |
|
|
46 | (1) |
|
|
46 | (10) |
|
|
56 | (1) |
|
Questions/Comments for Discussion |
|
|
57 | (1) |
|
|
57 | (2) |
|
|
59 | (3) |
|
4 Persuading through Style |
|
|
62 | (23) |
|
|
62 | (1) |
|
Technical Prose as Persuasion |
|
|
63 | (1) |
|
|
64 | (3) |
|
Some Practical Consequences of the New Rhetoric of Science |
|
|
67 | (3) |
|
Persuasion and Technical Prose Style |
|
|
70 | (1) |
|
Rhetorical Choices and Style |
|
|
70 | (1) |
|
Persuasive Strategies and Stylistic Choices |
|
|
71 | (4) |
|
Case Study 3 The Exxon Valdez and Persuasion |
|
|
75 | (1) |
|
|
75 | (4) |
|
Questions/Topics for Discussion |
|
|
79 | (1) |
|
|
80 | (2) |
|
|
82 | (3) |
|
5 Choosing Appropriate Words--Diction |
|
|
85 | (33) |
|
|
85 | (1) |
|
|
86 | (1) |
|
|
87 | (3) |
|
Denotation and Connotation |
|
|
90 | (1) |
|
Challenges Presented by Specialized Diction |
|
|
90 | (1) |
|
Major Diction Strategies in Technical Prose |
|
|
91 | (6) |
|
|
97 | (9) |
|
Technical Prose and a Literary Style |
|
|
106 | (3) |
|
On Euphemisms and Dysphemisms |
|
|
109 | (1) |
|
|
110 | (1) |
|
Case Study 4 The Ruby Ridge Incident and Diction |
|
|
110 | (3) |
|
Questions/Topics for Discussion |
|
|
113 | (1) |
|
|
113 | (1) |
|
|
114 | (4) |
|
6 Handling Technical Terms and Jargon |
|
|
118 | (26) |
|
|
118 | (1) |
|
|
119 | (1) |
|
Words, Terms, and Terminology |
|
|
120 | (1) |
|
Technical Terms as Jargon |
|
|
120 | (2) |
|
The Challenges of Using Technical Terms |
|
|
122 | (3) |
|
The Challenges of Using Jargon |
|
|
125 | (4) |
|
Other Specialized Languages |
|
|
129 | (4) |
|
Abbreviations, Acronyms, Initialisms |
|
|
133 | (1) |
|
Tips for Using Clear Technical Language |
|
|
134 | (1) |
|
|
134 | (1) |
|
Case Study 5 Apollo 13 and Jargon |
|
|
135 | (3) |
|
Questions/Topics for Discussion |
|
|
138 | (1) |
|
|
139 | (2) |
|
|
141 | (3) |
|
7 Creating Sentences with Style |
|
|
144 | (19) |
|
|
144 | (1) |
|
Sentences in Technical Prose |
|
|
145 | (1) |
|
A Brief Review of Sentence Basics |
|
|
145 | (5) |
|
Sentence Combining Techniques |
|
|
150 | (3) |
|
|
153 | (2) |
|
|
155 | (1) |
|
|
155 | (1) |
|
Sentence Elegance in Technical Prose |
|
|
156 | (1) |
|
|
156 | (2) |
|
|
158 | (1) |
|
Questions/Topics for Discussion |
|
|
159 | (1) |
|
|
159 | (2) |
|
|
161 | (2) |
|
8 Structuring Paragraphs and Other Segments |
|
|
163 | (24) |
|
|
163 | (1) |
|
Writing Technical Paragraphs |
|
|
164 | (1) |
|
|
164 | (3) |
|
Developing the Paragraph Topic |
|
|
167 | (7) |
|
Achieving an Effective Flow |
|
|
174 | (3) |
|
Providing Adequate Details |
|
|
177 | (2) |
|
Larger Segments in Technical Prose |
|
|
179 | (1) |
|
|
179 | (1) |
|
|
180 | (1) |
|
Questions/Topics for Discussion |
|
|
181 | (1) |
|
|
181 | (3) |
|
|
184 | (3) |
|
9 Establishing an Appropriate Tone |
|
|
187 | (28) |
|
|
188 | (1) |
|
|
188 | (2) |
|
|
190 | (12) |
|
Strategies for Developing an Appropriate Tone |
|
|
202 | (2) |
|
Humor in Technical Writing |
|
|
204 | (3) |
|
|
207 | (1) |
|
Case Study 6 Computer Viruses and Tone |
|
|
208 | (3) |
|
Questions/Topics for Discussion |
|
|
211 | (1) |
|
|
211 | (2) |
|
|
213 | (2) |
|
10 Considering Style and Bias |
|
|
215 | (21) |
|
|
215 | (1) |
|
|
216 | (2) |
|
|
218 | (10) |
|
|
228 | (1) |
|
|
229 | (1) |
|
Case Study 7 Gender-Neutral Language |
|
|
230 | (1) |
|
Questions/Topics for Discussion |
|
|
231 | (1) |
|
|
232 | (1) |
|
|
233 | (3) |
|
11 Determining the Ethics of Style |
|
|
236 | (17) |
|
|
236 | (1) |
|
|
237 | (1) |
|
Ethics and Technical Prose |
|
|
238 | (1) |
|
Ethics and the Professions |
|
|
238 | (3) |
|
Criteria for Judging Ethical Actions |
|
|
241 | (1) |
|
|
242 | (3) |
|
|
245 | (1) |
|
|
246 | (1) |
|
Case Study 8 Deception and the Exxon Valdez |
|
|
247 | (2) |
|
Questions/Topics for Discussion |
|
|
249 | (1) |
|
|
249 | (3) |
|
|
252 | (1) |
|
|
253 | (17) |
|
|
254 | (1) |
|
Misconceptions about Editing |
|
|
255 | (1) |
|
|
256 | (2) |
|
The Challenges of Editing for Style |
|
|
258 | (1) |
|
Strategies to Help You Edit for Style |
|
|
259 | (5) |
|
|
264 | (1) |
|
|
265 | (1) |
|
Questions/Topics for Discussion |
|
|
265 | (1) |
|
|
266 | (3) |
|
|
269 | (1) |
Glossary |
|
270 | (10) |
Bibliography |
|
280 | (10) |
Index |
|
290 | |