blob: 88837f02a4f7d1b3d74d6ddd5fbc64d529c47339 [file] [log] [blame]
This file has some general information about how 971 does code reviews.
We use Rietveld (<https://code.google.com/p/rietveld>) running in an app engine
app of ours. It is at <http://971code.appspot.com/>.
[General Procedure]
We try to code review all code before it gets checked in to svn. Code reviews
are also sometimes useful for getting feedback about documentation etc.
First, somebody starts a code review and sends out emails to people asking them
to look. Then, other people look at it and make suggestions (in the form of
comments). The person who started the review (the owner of it) looks at the
comments and responds to them and/or changes their code and uploads new
versions for everybody to look at. Once all of the reviewers approve the code,
the owner checks it in and closes the code review (issue).
[Reviewing]
This is the section for people who have received emails about reviewing code
should look.
The email that you receive will have a link to the issue (like
<http://971code.appspot.com/82001/>). Click on it to go to the issue page.
The most useful form of diff are the "Side-by-side diffs". Click the "View"
link in that column next to each file to look at it. After the first set of
comments, the "Delta from patch set" links are also helpful to see what got
changed so that you don't have to look at everything agin. While looking at
a diff, double-click on any line of code to leave a comment there. You can
also reply to existing comments. The web interface sometimes "eats" comments
right after you create/edit them. Refresh the page to fix that (don't just do
it again, or you'll end up with 2 identical comments). Once you are done
looking at all of the files and making comments, click the
"Publish+Mail Comments" link (at the top of each diff or on the left of the
main issue page) to send out your comments. You can also put general notes in
the "Message" box. If you think that it looks good, then put "LGTM" somewhere
in the message. The owner of the code review will keep looking at your
comments, making changes, and sending out more messages until it's finished.
TODO(brians): add information about starting a review
For more information about using Rietveld, see
<https://code.google.com/p/rietveld/wiki/CodeReviewHelp>.