Handbook of Technical Writing

  • Published on

  • View

  • Download

Embed Size (px)


Present evidence and reasons in support of their ideas Listen closely to other view points Carefully consider the merits and drawbacks of all opinions presented Work towards a solution by building and imporving on all ideas presented Five Key Strategies 21 another helpful website Conflict 22 Consensus 23 Identifying Major Tasks 13 Gender division in labor 14 Primary task Secondary task Research and Outlining 15 Planning 16 HTW Related content Scheduling the Task 17 Balancing the work task Technology & Tools for Task Schedules Assigning Major Roles: Motivation vs Experience HTW Related Topics Engaging in Constructive conflict 20

Chapter 5 - Constructive 19 Conflict

Chapter 4: Getting Started with the task schedulePrepare Students for workplace Employers want to hire experienced people who know how to collaborate Why Teamwork? Saves time and money Learn from peers Motivation by others Learn by teaching others Face-to-Face team writes together

Online Calendar 18No account sign in necessary Easy to edit & arrange Assigns a web address to the list: return, share, save After checking off completed goal the list remains below as completed. The list could effectively show how many completed goals as a way to measure goals. www.listmoz.com

Online To-Do List chapter 1 Georgia

Understanding Collaboration Methods


Group breaks docs into sections Each is assigned roles


each add to the product accumulates in layers

Alternating Collaboration Methods Team Charter 7 Measurable Goals 9 Personal Goals 10 Team Goals 8 Related Internet Sites http://www.io.com/~hcexres/textbook/team.html#teamwriting http://www.allbusiness.com/human-resources/employee-development-team-building/339377-1.html size requires more people because of time restraints HTW Related topics Teams are formed when: requires multiple areas of expertise melding of divergent views Produces Documents Negative factors Project Manager Purpose Task Shedule Creates Deadlines Starts Process with a Straw Document

Team Writing Handbook Chapter 3--------Getting Started with the Team

Individual Commitment: What 11 kind of effort will each invest? Irreconcilable differences Late Work Unacceptable Work Putting it all together 12 Build revision and feedback into task schedule. Decide on a revision process & follow it Use writing software that keeps a history of revision Include a statement about the importance of revision and feedback in the team charter Feedback 3 Direct Revision 4 Two types if Revision Developing Culture: Encouraged Constructive Feedback

Chapter 2 John


Meeting agendas Waste time

Meeting minutes and accountability 2

Dangers of operation without minutes

proceed without consensus Forget Details Encourage Slackers

The Benefits of a Diverse team Understanding norms Individual Norn Communication Norm Learn how over come the competitive speaker with strategy

clarify the state of the draft Clarify the goals of the revision or feedback Review he assignment instruction sheet (make a checklist of the criteria) Check against the grading rubric Review team charter Listening and Negotiating 5 e-mail Google docs Wikis Gliffy HTW Related 6 Technology Missing Meetings Missing a deadline Incomplete work Poor Quality Work Completely disappears Trust among the team Team doesn't listen Other team members are not commited Team mates saying demeaning things Not open to revison My team is destroying my work Not giving adequate feedback Not sure how to give feedback Designate a team coordinator Identify the audience, purpose, context and scope of the project Create a project plan, including a schedule and standards create a working outline of the document Assign segments or tasks to each member of the team Research and write drafts of document segments Follow the schedule: due dates for drafts, revisions and final versions Use the agreed-upon standards for style and format Exchange segments for team member reviews Collaborative Writing Checklist Related HTW Problems with revison Problems with personal interactions Not showing up and turning in work Ground Rules

Chapter 7 - Communication Styles and Team Diversity Chapter 6 Revising with Others

Differences in norms cause interpersonal conflict

Competitive versus considerate conversational norms

Competitive Hierarchical Considerate

Back Channeling Gender and Communication Norms 1 Self-promoting versus self deprecating-speech Action Oriented Vs Holistic Probem Solving Social Rules

Providing Effective Feedback & Making Good Revisions

Chapter 8 - Trouble Shooting Team Problems

Notes1) Gender and Communication NormsTheEnglishlanguage has an almost complete lack of gender distinction. This can be confusing fr those who may not speakEnglishas a first language. Its important that this is understood in writing as well as speaking. HTW - 226

2) Meeting minutes and accountabilityOrganizations and committees hat keepofficialrecord of their meetings refer to such as minutes. They are often used to settle disputes so they must be accurate. HTW 332

3) Feedbackthe feedback method allows the author to compile several comments from people with various backgrounds and perspectives which can also free up other team members to work on other areas of the project because it takes a shorter time to comment than to implement a direct revision. (p. 62)

4) Direct Revisionthe resposibility isshared by several people who are able to share and "draw from one another's strengths and directly change, recognize, and add to the text." (p. 62)

5) Listening and NegotiatingResponding to feedback is by far one of the most difficult parts of being on a team. Having the ability to respond well shows great professionalism. Do not ignore team feedback--it can make people start to that their input was not valuable or that you are closed minded and lazy!

6) HTW Relatedincorporating tracked changes: "When collegues review your document, they can track changes and insert comments within the document itself. Tracking and commenting vary with types and versions of word processoring programs, but in most programs you can view the tracked changes on a single draft or review the multiple drafts of your reviewers' versions." (p. 489)

7) Team CharterAn ounce of prevention is worth a pound of cure. A brief informational document that describes the big picture.

8) Team GoalsWhatconstitutessuccess Collaborativewriting - When one or more writers share a work and produce a single document. HTW - 72

9) Measurable GoalsSet benchmarks and deadlines to achieve them Examples: "meeting or beating all the deadlines set out in the task schedule"

"Creating a website that four out of five classmates rank as user-testing" Georgia

10) Personal GoalsExamples of what team members might individually want to achieve: "Improve writing skills" "Learning how to create a visually compelling Power Point presentation" "Creating a document that I can talk about on a job interview" "Having a productive and friendly team experience" "Completing the project with little effort as possible" (p.32) Georgia

11) Individual Commitment: What kind of effort will each invest?Some team members may not invest enough into the work. There are a couple options: Assign these team members with fewer or less critical tasks and if they fail the others can pick up the slack. There can be a negotiation about less work = lower grade as an option for those who are not willing to work hard enough for a higher grade and therefore cutting costs on the other students. The teacher should be informed or consenting. These kinds of preliminary options can protect and save time and stress. Georgia

12) Putting it all togetherContent Management -Writing in a content managementenvironmentchallengeswritersto think of an audience, purpose and context broadly HTW - 97

13) Identifying Major TasksThe first step for getting a task schedule going is to brainstorm all the major tasks for the team to perform. (p. 40) Georgia

14) Gender division in laborThis is where woman do the writing and men do the technical work. Many things that are written in groups can beinterpreteddifferently. Its important that its genderspecific. The gender of most words can be identified only by the choice of the appropriate pronoun. Gender is important to writers because they must be sure that nouns and pronouns withingrammaticalconstruction agree in gender. HTW- 226

15) Research and OutliningThis is the stage the team finishes research tasks, broad outline, and assigning writing tasks to each member "based on their expertise and the outline." (p. 73).

16) Planning"The team estabishes a project plan that may include guidelines for communication... the plan includes a schedule with due dates for completing initial research tasks, outlines, drafts, reviews, revisions, and the final document." (p. 73) Georgia

17) Scheduling the TaskIt is wise to write up a rough draft of a task schedule, so members can reflect and improve it. (p. 44) Georgia

18) Online CalendarWe feel that this calendar would be a useful tool to any groupcollaboratingon a project. It has many important features and allows multiple users to access it. It is very similar to Google calendars which is a very user friendly application.

19) Chapter 5 - Constructive ConflictConstructive Conflict is the healthy, respectful debate of ideas andcompetingsolutions to a problem.

20) Engaging in Constructive conflictTasks of the Collaborative Writing Team Reviewing - Keeping the audiences needs and the documents purpose in mind, each team member critcally yet diplomatically reviews the other team members drafts, from the overall organization to the clarity of each paragraph, and offers advice to help improve the writers work. HTW - 73

21) Five Key Strategies Goodwill and responsible behavior is not always going to lead to constructive conflict so here are some strategies to help: "Clarify Roles and Responsibilities up front in a task schedule" "Include revision in the task schedule and allow plenty of time to implement revisions." "Lay ground rules for conversation: Set aside time for brainstorming, Get input from everyone in the group, and restate ideas, set time limits." "Decide in advance how impasses will be handled." Such as group consensus, majority rules, supervisor decides, client decides." "Establish team priorities in a team charter or project plan." (P. 56) Georgia

22) ConflictThere is going to be disharmony as teams collaborate the best treatment is mutual respect. Because most team members may not always agree on every subject it can lead to conflict, large or small. "Creative differences resolved respectfully can energize the team and, in fact, strengthen a finished document by compelling writers to reexamine assumptions and issues in unanticipated ways." (p. 74) Georgia

23) ConsensusConsensus: "Harmony of Opinion" (p. 96) Georgia