Difference between revisions of "Code Review"

From Dreamwidth Notes
Jump to: navigation, search
(Created page with '{{Note|text=This article is a work in progress and should be reviewed by <dwuser>mark</dwuser> before being taken as advice.}} Code Review is an important task that must be done...')
 
 
(11 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Note|text=This article is a work in progress and should be reviewed by <dwuser>mark</dwuser> before being taken as advice.}}
+
Code Review is an important task that must be done for pull requests submitted to GitHub.  By doing this task, you help <dwuser>mark</dwuser> and <dwuser>fu</dwuser> spend less time doing code review and more time coding.
  
Code Review is an important task that must be done for patches submitted to [[Bugzilla]]. By doing this task, you help <dwuser>mark</dwuser> spend less time doing code review and more time coding.
+
You can find pull requests for the two main code repositories:
 +
 
 +
* [https://github.com/dreamwidth/dw-free/pulls dw-free]
 +
* [https://github.com/dreamwidth/dw-nonfree/pulls dw-nonfree]
  
 
== Code Review Steps ==
 
== Code Review Steps ==
Line 7: Line 10:
 
=== Style compliance ===
 
=== Style compliance ===
  
Run through the [[Programming Guideline Checklist]].  If the patch violates any of these guidelines, reject with specific instructions on what is wrong.
+
Run through the [[Programming Guideline Checklist]].  If the patch violates any of these guidelines, comment with specific instructions on what is wrong, ideally on the lines that have violations.
  
=== Apply the Patch ===
+
=== Build a test-case ===
  
Update to the latest committed code, as per the instructions in [[Dev Maintenance]].  Apply the patch (you might want to use Mercurial Queues for this--see [[Dev Version Control]]). If the patch doesn't apply cleanly, reject with a note to check their patch against the latest committed code.  They may have forgotten to update before submitting, or there may have been changes committed since they submitted!
+
Look at what the patch is supposed to fix and reproduce it on your own installation. Already at this step it is best to think of several ways this patch can be tested so you can see what happens before and after you apply the patch.
 +
 
 +
=== Apply the branch from the pull request ===
 +
 
 +
Update to the latest committed code, as per the instructions in [[Dev Maintenance]].  Apply the commits from the pull request.  The easiest way to do this is checking out the master branch (git checkout master) and then using [http://hub.github.com/ the hub command] (if it is installed) with the link to the pull request:
 +
 
 +
  hub checkout https://github.com/dreamwidth/dw-free/pull/000
 +
 
 +
If the pull request doesn't apply cleanly to the master branch, comment with a note to check their branch against the latest committed code.  They may have forgotten to update before submitting, or there may have been changes committed since they submitted!
  
 
=== Test the functionality ===
 
=== Test the functionality ===
  
Note what the bug patch is meant to fix.  Verify that the issue is fixed or that the new feature is working properly.  Try to see if you can make things break.   
+
Note what the pull request is meant to fix. (The originating issue number should be in the title of the branch and each commit.) Verify that the issue is fixed or that the new feature is working properly.  Try to see if you can make things break.   
 +
 
 +
Suggestions for things to test for, as applicable: test with paid, free, personal and community accounts, logged in and logged out, use different site schemes and layouts, try foreign characters in user input or empty input, entries and user names that don't exist, and anything else you can think of.
  
=== Remove the review tag ===
+
=== Make appropriate commentary ===
  
If the patch follows style guidelines, applies cleanly, and functions, you may now note that you have reviewed the patch for all of these and remove the review tag. If a commit tag is there, leave itIf a commit tag is not there, tell the person that they should add it if they are ready for the patch to be committed. (Sometimes people want patches to be reviewed before they are ready to be committed!)
+
* If the patch follows style guidelines, applies cleanly, and functions, you may now note that you have reviewed the patch for all of these in a comment.
 +
* If you find a patch still needs work, you can explain in a clear and friendly manner what should be done in a commentIdeally, match the commentary as line comments on the sections that need wor.
  
 
[[Category: Development]]
 
[[Category: Development]]

Latest revision as of 17:05, 1 July 2019

Code Review is an important task that must be done for pull requests submitted to GitHub. By doing this task, you help [info]mark and [info]fu spend less time doing code review and more time coding.

You can find pull requests for the two main code repositories:

Code Review Steps

Style compliance

Run through the Programming Guideline Checklist. If the patch violates any of these guidelines, comment with specific instructions on what is wrong, ideally on the lines that have violations.

Build a test-case

Look at what the patch is supposed to fix and reproduce it on your own installation. Already at this step it is best to think of several ways this patch can be tested so you can see what happens before and after you apply the patch.

Apply the branch from the pull request

Update to the latest committed code, as per the instructions in Dev Maintenance. Apply the commits from the pull request. The easiest way to do this is checking out the master branch (git checkout master) and then using the hub command (if it is installed) with the link to the pull request:

hub checkout https://github.com/dreamwidth/dw-free/pull/000

If the pull request doesn't apply cleanly to the master branch, comment with a note to check their branch against the latest committed code. They may have forgotten to update before submitting, or there may have been changes committed since they submitted!

Test the functionality

Note what the pull request is meant to fix. (The originating issue number should be in the title of the branch and each commit.) Verify that the issue is fixed or that the new feature is working properly. Try to see if you can make things break.

Suggestions for things to test for, as applicable: test with paid, free, personal and community accounts, logged in and logged out, use different site schemes and layouts, try foreign characters in user input or empty input, entries and user names that don't exist, and anything else you can think of.

Make appropriate commentary

  • If the patch follows style guidelines, applies cleanly, and functions, you may now note that you have reviewed the patch for all of these in a comment.
  • If you find a patch still needs work, you can explain in a clear and friendly manner what should be done in a comment. Ideally, match the commentary as line comments on the sections that need wor.