Difference between revisions of "Code Review"

From Dreamwidth Notes
Jump to: navigation, search
m (Apply the Patch)
(Code Review Steps)
Line 8: Line 8:
  
 
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, reject with specific instructions on what is wrong.
 +
 +
=== 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 Patch ===
 
=== Apply the Patch ===
Line 16: Line 20:
  
 
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 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.   
 +
 +
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 ===
 
=== Remove the review tag ===

Revision as of 15:49, 6 August 2009

Note: This article is a work in progress and should be reviewed by [info]mark before being taken as advice.

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

Code Review Steps

Style compliance

Run through the Programming Guideline Checklist. If the patch violates any of these guidelines, reject with specific instructions on what is wrong.

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 Patch

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!

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.

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

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 it. If 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 finished working on them!)