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
- Read the cover
letter -- not the full paper (yet) -- and write the
answers
to these questions:
- Does the cover
letter have the form of a letter, with salutation and
closing?
- Does the letter
clearly and concisely describe a number of specific
changes
to the system?
- Now read the full
proposal and write answers to these questions:
- Is the
proposal's tone formal, business-like, rational, and convincing?
- Does the
proposal clearly and specifically identify several changes to
the existing system, and give a brief justification for each change?
- 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?
- Are there any
mechanical errors (spelling, punctuation, grammar) that
interfered
with your reading of the proposal?
- Is the overall
structure of the proposal easy to follow and understand?
Is there a helpful introduction and conclusion?
- Now reread the
cover letter and write answers to these questions:
- 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?
- Review your comments with the author
(and vice versa).