Upon completion of this chapter, readers will be able to: Explain and apply strategies for peer reviewing. Explain and apply strategies for team writing

McMurrey, David

English

DigitalCommons@Kennesaw State University

Kennesaw State University DigitalCommons@Kennesaw State University Open Technical Communication Open Educational Resources 7-1-2019 05.10: Strategies for Peer-Reviewing and Team Writing David McMurrey hcexres@io.com Follow this and additional works at: https://digitalcommons.kennesaw.edu/opentc  Part of the Technical and Professional Writing Commons Recommended Citation McMurrey, David, "05.10: Strategies for Peer-Reviewing and Team Writing" (2019). Open Technical Communication. 35. https://digitalcommons.kennesaw.edu/opentc/35 This Article is brought to you for free and open access by the Open Educational Resources at DigitalCommons@Kennesaw State University. It has been accepted for inclusion in Open Technical Communication by an authorized administrator of DigitalCommons@Kennesaw State University. For more information, please contact digitalcommons@kennesaw.edu. 1/8/2020 Strategies for Peer Reviewing and Team Writinghttps://softchalkcloud.com/lesson/files/vEQfgsYbIm3cUy/5_10Peer-ReviewTeam-Writing_print.html 1/6Strategies for Peer Reviewing and Team Writing David McMurreyChapter ObjectivesUpon completion of this chapter, readers will be able to:1. Explain and apply strategies for peer reviewing.2. Explain and apply strategies for team writing.Strategies for Peer Reviewing and Team Writing Be a thoughtful reviewer; be a good team memberPeer reviewing (also called peer-editing) means people getting together to read, comment on, and recommendimprovements on each other's work. Peer-reviewing is a good way to become a better writer because it providesexperience in looking critically at writing.Team writing, as its name indicates, means people getting together to plan, write, and revise writing projects as a group,or team. Another name for this practice is collaborative writing—collaborative writing that is out in the open rather thanunder cover (where it is known as plagiarism).Strategies for Peer ReviewingWhen you peer-review another writer's work, you evaluate it, criticize it, suggest improvements, and then communicateall of that to the writer. As a first-time peer-reviewer, you might be a bit uneasy about criticizing someone else's work. Forexample, how do you tell somebody his essay is boring? Read the discussion and steps that follow; you'll find advice andguidelines on doing peer reviews and communicating peer-review comments.Initial meetingAt the beginning of a peer review, the writer should provide peer reviewers with notes on the writing assignment and ongoals and concerns about the writing project (topic, audience, purpose, situation, type), and alert them to any problemsor concerns. As the writer, you want to alert reviewers to these problems; make it clear what kinds of things you weretrying to do. Similarly, peer reviewers should ask writers whose work they are peer-reviewing to supply information ontheir objectives and concerns. The peer-review questions should be specific like the following:Does my expanation of virtual machine make sense to you? Would it make sense to our least technical customers? In general, is my writing style too technical? (I may have mimicked too much of the engineers' specifications.) Are the chapter titles and headings indicative enough of the following content? (I had trouble phrasing some of these.) Are the screen shots clear enough? (I may have been trying to get get too much detail in some of them.)Peer-reviewing strategiesWhen you peer-review other people's writing, remember above all that you should consider all aspects of that writing, notjust—in fact, least of all—the grammar, spelling, and punctuation. If you are new to peer-reviewing, you may forget toreview the draft for things like the following:Make sure that your review is comprehensive. Consider all aspects of the draft you're reviewing, not just thegrammar, punctuation, and spelling.Read the draft several times, looking for a complete range of potential problem areas:Interest level, adaptation to audiencePersuasiveness, purposeContent, organizationClarity of discussionCoherence, use transition1/8/2020 Strategies for Peer Reviewing and Team Writinghttps://softchalkcloud.com/lesson/files/vEQfgsYbIm3cUy/5_10Peer-ReviewTeam-Writing_print.html 2/6Title, introduction, and conclusion.Sentence style and clarityHandling of graphicsBe careful about making comments or criticisms that are based on your own personal style. Base your criticismsand suggestions for improvements on generally accepted guidelines, concepts, and rules. If you do make acomment that is really your own preference, explain it.Explain the problems you find fully. Don't just say a paper "seems disorganized." Explain what is disorganizedabout it. Use specific details from the draft to demonstrate your case.Whenever you criticize something in the writer's draft, try to suggest some way to correct the problem. It's notenough to tell the writer that her paper seems disorganized, for example. Explain how that problem could besolved.Base your comments and criticisms on accepted guidelines, concepts, principles, and rules. It's not enough to tella writer that two paragraphs ought to be switched, for example. State the reason why: more general, introductoryinformation should come first, for example.Avoid rewriting the draft that you are reviewing. In your efforts to suggest improvements and corrections, don't gooverboard and rewrite the draft yourself. Doing so steals from the original writer the opportunity to learn andimprove as a writer.Find positive, encouraging things to say about the draft you're reviewing. Compliments, even small ones, areusually wildly appreciated. Read through the draft at least once looking for things that were done well, and then letthe writer know about them. Peer-review summaryOnce you've finished a peer review, it's a good idea to write a summary of your thoughts, observations, impressions,criticisms, or feelings about the rough draft. See the peer-reviewer note below, which summarizes observations on arough draft. Notice in the note some of the following details:The comments are categorized according to type of problem or error—grammar and usage comments in onegroup; higher level comments on such things as content, organization, and interest-level in another group.Relative importance of the groups of comments is indicated. The peer-reviewer indicates which suggestions wouldbe "nice" to incorporate and which ones are critical to the success of the writing project.Most of the comments include some brief statement of guidelines, rules, examples, or common sense. Thereviewer doesn't simply say "This is wrong; fix it." He also explains the basis for the comment.Questions are addressed to the writer. The reviewer is doublechecking to see if the writer really meant to state orimply certain things.The reviewer includes positive comments to make about the rough draft and finds nonantagonistic, sympatheticways to state criticisms.Excerpt from a note summarizing the results of a peer reviewSpend some time summarizing your peer-review comments in a brief note to the writer. Be as diplomatic andsympathetic as you can!Strategies for Team WritingAs mentioned earlier in this chapter, team writing is one of the common ways people in the worlds of business,government, science, and technology handle large writing projects.Assembling the teamWhen you begin picking team members for a writing project in a technical writing course, choose people with differentbackgrounds and interests. Just as a diverse, well-rounded background for an individual writer is an advantage, a groupof diverse individuals makes for a well-rounded writing team.If you are the team leader, you might even ask prospective team members for their background, interests, majors,talents, and aptitudes. These following writing teams combine individuals with diverse backgrounds and interests:Writing Team 1Project: A report on current cloaking technologiesTeam members Backgrounds, skills, interests1/8/2020 Strategies for Peer Reviewing and Team Writinghttps://softchalkcloud.com/lesson/files/vEQfgsYbIm3cUy/5_10Peer-ReviewTeam-Writing_print.html 3/6Shawn S. Electrical engineering major, currently doing basic office-management chores at a law firmTracey K. Senior English major, hoping this course helps with employment prospectsSanjiv Gupta Computer science major, currently doing computer graphics at a software development shopJeon Chang Yeon Soon-to-be electrical engineering major, still developing English language skillsAlice B. Undeclared major with a nontechnical focus, possibly in the wrong course, no stated skills Planning the projectOnce you've assembled your writing team, most of the work is the same as it would be if you were writing by yourself,except that each phase is a team effort. Specifically, meet with your team to decide or plan the following:Planning StagesAnalyze the writing assignment.Pick a topic.Define the audience, purpose, and writing situation.Brainstorm and narrow the the topic.Create an outline.Plan the information search (for books, articles, etc., in the library).Plan a system for taking notes from information sources.Plan any graphics you'd like to see in your writing project.Agree on style and format questions (see the following discussion).Develop a work schedule for the project and divide the responsibilities (see the following).Much of the work in a team-writing project must be done by individual team members on their own. However if your teamdecides to divide up the work for the writing project, try for at least these minimum guidelines:Have each team member responsible for the writing of one major section of the paper.Have each team member responsible for locating, reading, and taking notes on an equal part of the informationsources.Some of the work for the project that could be done as a team you may want to do first independently. For example,brainstorming, narrowing, and especially outlining should be done first by each team member on his own; then gettogether and compare notes. Keep in mind how group dynamics can unknowingly suppress certain ideas and how lessassertive team members might be reluctant to contribute their valuable ideas in the group context.After you've divided up the work for the project, write a formal chart and distribute it to all the members.  1/8/2020 Strategies for Peer Reviewing and Team Writinghttps://softchalkcloud.com/lesson/files/vEQfgsYbIm3cUy/5_10Peer-ReviewTeam-Writing_print.html 4/6Scheduling the project and balancing workloadEarly in your team writing project, set up a schedule of key dates. This schedule will enable you and your team membersto make steady, organized progress and complete the project on time. As shown in the example schedule below, includenot only completion dates for key phases of the project but also meeting dates and the subject and purpose of thosemeetings. Notice these details about that schedule:Several meetings are scheduled in which members discuss the information they are finding or are not finding.(One team member may have information another member is looking everywhere for.)Several meetings are scheduled to review the project details, specifically, the topic, audience, purpose, situation,and outline. As you learn more about the topic and become more settled in the project, your team may want tochange some of these details or make them more specific.Several rough drafts are scheduled. Team members peer-review each other's drafts of individual sections twice,the second time to see if the recommended changes have worked. Once the complete draft is put together, it, too,is reviewed twice.Schedule for a team writing projectIndividual prototypes due October 1Team meeting: finalize the prototype October 1Rough-draft style guide due October 5Team meeting: finalize style guide October 5Twice-weekly team meetings: progress & problems October 5-26Graphics sketches due to Jim October 14Rough drafts of individual sections due October 26Review of rough drafts due October 28Team meeting: discuss rough drafts, reviews October 28Update of style guide due from Sterlin October 31Revisions of rough drafts due to reviewers November 3Final graphics due from Jim November 5Completed drafts to Sterlin: final edit/proof November 7Team meeting: review completed drafts with final graphics and editing November 12Completed drafts due to Julie for final production November 151/8/2020 Strategies for Peer Reviewing and Team Writinghttps://softchalkcloud.com/lesson/files/vEQfgsYbIm3cUy/5_10Peer-ReviewTeam-Writing_print.html 5/6Team meeting: inspection of completed project November 15Project upload due to McMurrey November 16Party at Julie's November 19When you work as a team, there is always the chance that one of the team members, for whatever reason, may havemore or less than a fair share of the workload. Therefore, it's important to find a way to keep track of what each teammember is doing. A good way to do that is to have each team member keep a journal or log of what kind of work shedoes and how much time she spends doing it.At the end of the project, if there are any problems in the balance of the work, the journal should make that fact veryclear. At the end of the project, team members can add up their hours spent on the project; if anyone has spent a littlemore than her share of time working, the other members can make up for it by buying her dinner or some reward likethat. Similarly, as you get down toward the end of the project, if it's clear from the journals that one team member's workresponsibilities turned out, through no fault of his own, to be smaller than those of the others, he can make up for it bydoing more of the finish-up work such as typing, proofing, or copying.Setting up a style guide or style sheetBecause the individual sections will be written by different writers who are apt to have different writing styles, set up astyle guide in which your team members list their agreements on how things are to be handled in the paper as a whole.These agreements can range from the high level, such as whether to have a background section, all the way down topicky details such as when to use italics or bold and whether it is "click" or "click on." See the excerpt from a project stylesheet in the following.Before you and your team members write the first rough drafts, you can't expect to cover every possible difference instyle and format. Therefore, plan to update this style sheet when you review the rough drafts of the individual sectionsand, especially, when you review the complete draft.Highlighting1. Use bold for interface elements that function like commands (for example, the Exit button).2. Use bold for menu options that get you to commands (for example, File>Open).3. Use the > symbol to abbreviate menu traversal.4. Use Courier New for example text that users type in (for example, myfile.doc).5. Use italics for variables--placeholder text for which users substitute their own information (for example,filename.doc).Hyphenation1. Individual words. Turn automatic hyphenation off. Do not hyphenate words except in tight places like tables orgraphics.2. Compounds. Mr. Hyphen (Sterlin) will keep the hyphenated-compounds list. Use only those in his list, and submitnew ones to him for approval and inclusion on the list. (Hyphenate compounds only for approval and inclusion onthe list. [Hyphenate compounds only when they modify (for example, "back-up copy"), not when they act asnouns or verbs (for example, "to back up your files.")]Terminology1. Use only the words in graph_project.dic. Sterlin approves all new words for that database.2. Use the same word for the same object, same process, or same action. No elegant variation, please!Excerpt from a style guide for a writing project. The items listed represent agreements team writers have made in orderto give their paper as much consistency as possible.Reviewing drafts and finishing1/8/2020 Strategies for Peer Reviewing and Team Writinghttps://softchalkcloud.com/lesson/files/vEQfgsYbIm3cUy/5_10Peer-ReviewTeam-Writing_print.html 6/6Try to schedule as many reviews of your team's written work as possible. You can meet to discuss each other's roughdrafts of individual sections as well as rough drafts of the complete paper.A critical stage in team-writing a paper comes when you put together into one complete draft those individual sectionswritten by different team members. It's then that you'll probably see how different in tone, treatment, and style eachsection is. You must as a group find a way to revise and edit the complete rough draft that will make it read consistentlyso that it won't be so obviously written by three or four different people.When you've finished with reviewing and revising, it's time for the finish-up work to get the draft ready to hand in. Thatwork is the same as it would be if you were writing the paper on your own, only in this case the workloads can be dividedup.

05.10: Strategies for Peer-Reviewing and Team Writing

https://digitalcommons.kennesaw.edu/cgi/viewcontent.cgi?article=1034&amp;context=opentc

05.10: Strategies for Peer-Reviewing and Team Writing

Abstract

Similar works

Full text

Available Versions

DigitalCommons@Kennesaw State University