A Note from the Series Editor |
|
ix | |
About the Authors |
|
xi | |
|
PART 1 A TECHNIQUE FOR WRITING LIKE A PROFESSIONAL |
|
|
1 | (78) |
|
|
3 | (4) |
|
1 The Social Situation of Text |
|
|
7 | (26) |
|
The Social Contexts for Technical Writing |
|
|
8 | (1) |
|
Models of the Writing Environment |
|
|
9 | (7) |
|
|
10 | (1) |
|
|
11 | (2) |
|
Cognitive/Behavioral Models |
|
|
13 | (1) |
|
|
14 | (2) |
|
|
16 | (16) |
|
The Rhetorical Situation: Purpose |
|
|
18 | (3) |
|
The Rhetorical Situation: Audience |
|
|
21 | (5) |
|
The Rhetorical Situation: Identity |
|
|
26 | (2) |
|
The Rhetorical Situation: Context |
|
|
28 | (1) |
|
The Pragmatic Situation: Community and Genre |
|
|
29 | (3) |
|
|
32 | (1) |
|
2 Making Writing Decisions |
|
|
33 | (46) |
|
|
34 | (1) |
|
Document Structure and Granularity |
|
|
35 | (2) |
|
Arranging Text at the Macro Level |
|
|
37 | (8) |
|
Sectioning and Heading Sections |
|
|
39 | (4) |
|
Aids for Navigating and Understanding Document Structure |
|
|
43 | (2) |
|
Creating Effects with Lexis and Syntax at the Micro Level |
|
|
45 | (23) |
|
Lexical Technique: Word Choice, Technical Terms, and Hedges and Boosters |
|
|
47 | (6) |
|
Syntactic Technique: Modification, Clausal Arrangement, and Discursive Cueing |
|
|
53 | (15) |
|
Intermediate Structural Units and Argumentative Movement |
|
|
68 | (7) |
|
Paragraph Cohesion and Paragraphs as Structural Units of a Document |
|
|
69 | (3) |
|
Structures Other than Paragraphs |
|
|
72 | (1) |
|
Citations and Other Intertextual Statements |
|
|
73 | (2) |
|
Implications for the Process of Writing |
|
|
75 | (2) |
|
|
77 | (2) |
|
|
79 | |
|
|
81 | (4) |
|
3 Writing to Know: Informative Documents |
|
|
85 | (24) |
|
|
86 | (1) |
|
The Purposes of Informative Documents |
|
|
86 | (2) |
|
Occasions for Preparing an Informative Document |
|
|
88 | (1) |
|
Audiences for an Informative Document |
|
|
88 | (2) |
|
Key Communication Strategies When Writing to Know |
|
|
90 | (3) |
|
Understanding What Constitutes Sufficient Evidence to Support a Claim |
|
|
90 | (1) |
|
Structuring Evidence in Your Document |
|
|
91 | (1) |
|
|
92 | (1) |
|
Questions for Analyzing Existing Documents |
|
|
93 | (1) |
|
Some Typical Informative Documents |
|
|
93 | (15) |
|
|
93 | (11) |
|
|
104 | (4) |
|
|
108 | (1) |
|
4 Writing to Enable: Instructions and Guidance |
|
|
109 | (24) |
|
|
110 | (1) |
|
The Purposes of Enabling Documents |
|
|
110 | (2) |
|
Occasions for Preparing an Enabling Document |
|
|
112 | (1) |
|
Audiences for an Enabling Document |
|
|
112 | (1) |
|
Key Communication Strategies When Writing to Enable |
|
|
113 | (6) |
|
Anticipating a Document's Use Context |
|
|
113 | (2) |
|
Deciding How Much Background Is Warranted |
|
|
115 | (1) |
|
Testing the Document with Users |
|
|
116 | (3) |
|
Questions for Analyzing Existing Documents |
|
|
119 | (1) |
|
Characteristic Enabling Documents |
|
|
119 | (14) |
|
Manuals/Guides and Other Documents That Primarily Contain Instructions/Directions/Procedures |
|
|
119 | (9) |
|
Tutorials/Training Materials |
|
|
128 | (2) |
|
|
130 | (3) |
|
5 Writing to Convince: Persuasive Documents |
|
|
133 | (22) |
|
|
134 | (1) |
|
The Purposes of Persuasive Documents |
|
|
134 | (1) |
|
Occasions for Preparing a Persuasive Document |
|
|
135 | (1) |
|
Audiences for the Persuasive Document |
|
|
136 | (1) |
|
Key Communication Strategies When Writing to Convince |
|
|
137 | (6) |
|
Designing Your Argument to Consider the Audience's Preexisting Beliefs |
|
|
137 | (3) |
|
Using the Terms and Values of the Audience to Articulate a Shared Goal |
|
|
140 | (2) |
|
Assuring Outcomes and Benefits without Seeming Unrealistic |
|
|
142 | (1) |
|
Questions for Analyzing Existing Documents |
|
|
143 | (2) |
|
Typical Examples of Persuasive Documents |
|
|
145 | (10) |
|
|
145 | (4) |
|
|
149 | (6) |
|
6 Correspondence: Medium of Workplace Collaboration |
|
|
155 | |
|
|
156 | (1) |
|
The Purposes of Correspondence |
|
|
157 | (1) |
|
Occasions for Preparing Correspondence |
|
|
158 | (1) |
|
Audiences for Correspondence |
|
|
158 | (2) |
|
Key Communication Strategies When Corresponding |
|
|
160 | (5) |
|
Consider Workplace Roles and Official and Unofficial Relationships and Responsibilities |
|
|
160 | (2) |
|
Evaluate Target Size and Frequency of Communication for a Relationship |
|
|
162 | (1) |
|
Pause to Reconsider Composition, Time, and Tone before Sending |
|
|
163 | (2) |
|
Characteristics of Correspondence Documents |
|
|
165 | (8) |
|
Letters, Memoranda, and E-mails |
|
|
165 | (2) |
|
|
167 | (3) |
|
Pre- and Post-meeting Documents: Announcements, Agendas, and Minutes |
|
|
170 | (1) |
|
|
171 | (2) |
|
Appendix: IEEE Style for References |
|
|
173 | (10) |
|
|
183 | |