docs/7_How_To_Contribute/5_Reviewing_Changes.md

   1 ---
   2 title: Reviewing Changes
   3 ---
   4
   5 1. Click on a link for incoming or outgoing review.
   6
   7 2. The details of the change and its current status are loaded:
   8
   9       ![review](images/review.png)
  10
  11       -  **Status:** Displays the current status of the change.
  12
  13       -  **Reply:** Click on this button after reviewing to add a final review
  14          message and a score, -1, 0 or +1.
  15
  16       -  **Patch Sets:** If multiple revisions of a patch exist, this button
  17          enables navigation among revisions to see the changes. By default, the
  18          most recent revision is presented.
  19
  20       -  **Download:** This button brings up another window with multiple
  21          options to download or checkout the current changeset. The button on
  22          the right copies the line to your clipboard. You can easily paste it
  23          into your git interface to work with the patch as you prefer.
  24
  25          Underneath the commit information, the files that have been changed by
  26          this patch are displayed.
  27
  28 3. Click on a filename to review it. Select the code base to differentiate
  29    against. The default is ``Base`` and it will generally be what is needed.
  30
  31 4. The review page presents the changes made to the file. At the top of the
  32    review, the presentation shows some general navigation options. Navigate
  33    through the patch set using the arrows on the top right corner. It is
  34    possible to go to the previous or next file in the set or to return to the
  35    main change screen. Click on the yellow sticky pad to add comments to the
  36    whole file.
  37
  38       The focus of the page is on the comparison window. The changes made are
  39       presented in green on the right versus the base version on the left.
  40       Double click to highlight the text within the actual change to provide
  41       feedback on a specific section of the code. Press *c* once the code is
  42       highlighted to add comments to that section.
  43
  44 5. After adding the comment, it is saved as a *Draft*.
  45
  46 6. Once you have reviewed all files and provided feedback, click the *green up
  47    arrow* at the top right to return to the main change page. Click the
  48    ``Reply`` button, write some final comments, and submit your score for the
  49    patch set. Click ``Post`` to submit the review of each reviewed file, as well
  50    as your final comment and score. Gerrit sends an email to the
  51    change-submitter and all listed reviewers. Finally, it logs the review for
  52    future reference. All individual comments are saved as *Draft* until the
  53    ``Post`` button is clicked.
  54
  55