Native Client Code Review and Check-in Process
- Designate owners for that subteam.
- Set policies for who can give LGTM for the modules owned by that subteam.
- Once OWNERS is implemented, there may be an approval step required in addition to (2).
- Read the coding style document.
- Run cpplint.py, pylint, tidy, etc., as appropriate.
- The change list comment should describe the change and whether it is a cosmetic change, a bug fix, or a new feature.
- Make sure the CL is passing trybots before sending out for review.
- Pick reviewers that are familiar with the code in question.
a) Pick more than one reviewer if the CL spans more than one module.
b) One LGTM per module touched is required.
c) (Multiple reviewer details to be worked out.)
- All review requests should be sent to email@example.com.
- All “significant” CLs have a BUG= line and an entry in the issue tracker.
e.g., CLs that fix misspellings in comments or improve coding convention conformance are not bug-worthy, while fixing a crasher or adding a new PPAPI interface is.
- All new code CLs have a TEST= line and one or more tests that exercise the new code. e.g., Changing comments does not require a test, while adding a new system call does. The test should be specific enough that the reviewer can reproduce it.
- Don’t re-upload the CL until addressing all of the reviewers’ comments from an iteration. Explicitly reply to comments in Rietveld.
(Rietveld makes it difficult to ensure all the comments were addressed.)
- The CL conforms to the NaCl coding conventions.
- The CL passed the trybots.
- The CL follows the designated author tasks above.
- You understand what the CL is doing and believe it is doing it correctly.
- Review iterations are completed within one business day or referred to another reviewer.
a) Repeated issues may be elided and another iteration required.
b) Large CLs may be broken into sub-reviews.
c) We encourage sending comments or feedback early so as to pipeline the fixes.
The reviewer may summarily reject the CL if it doesn’t follow (2-3). If you LGTM a CL that breaks the build, you share responsibility for the break.
- The first responsibility at all times is to keep the tree open. Even if that means going back to the last known good revision.
- Can summarily revoke CLs, and ask author or a reviewer(s) to do revocation.
- For more details, see http://www.chromium.org/developers/tree-sheriffs