ICS 139W Communications Skills for Computer Scientists

Peer Editing "System Change Proposal" - second draft

Work in pairs, with someone you haven't worked with yet this quarter. As you read and comment on each other's papers, keep in mind the purpose and audience of the paper (that is, to convince a senior executive in the organization to proceed with the system changes you propose).

The editor can mark-up the proposal, and will also write comments on a separate sheet of paper. Editors, make sure to write "Draft #2 Edited by" and your name at the top of both. Each author must turn in the editor's written comments along with the final version of the paper.

Procedure for Editors

  1. Read the cover letter -- not the full paper (yet) -- and write the answers to these questions:
    1. Does the cover letter have the form of a letter, with salutation and closing?
    2. Does the letter clearly and concisely describe a number of specific changes to the system?
  2. Now read the full proposal and write answers to these questions:
    1. Is the proposal's tone formal, business-like, rational, and convincing?
    2. Does the proposal clearly and specifically identify several changes to the existing system, and give a brief justification for each change?
    3. Given that the proposal will be read by senior executives who know the business but are probably not computer scientists, does the author provide sufficient background for any technical issues? Does the author use any jargon that might not be known to non-specialists?
    4. Are there any mechanical errors (spelling, punctuation, grammar) that interfered with your reading of the proposal?
    5. Is the overall structure of the proposal easy to follow and understand? Is there a helpful introduction and conclusion?
  3. Now reread the cover letter and write answers to these questions:
    1. Is the cover letter a good summary of the entire proposal? In the very likely scenario that an executive reads only the cover letter, would he or she still have enough information to evaluate the proposal?
  4. Review your comments with the author (and vice versa).