Commit 064574ce authored by Gabriel Charette's avatar Gabriel Charette Committed by Commit Bot

[Code Reviews Docs] Update TBR policy for mechanical changes

As discussed @
https://groups.google.com/a/chromium.org/d/topic/chromium-dev/829Jj5eBhbk/discussion

R=danakj@chromium.org

Change-Id: I6a0d4a2d4d3091a48cc6c66994f4842f69aa3a87
Reviewed-on: https://chromium-review.googlesource.com/c/1340262
Commit-Queue: Gabriel Charette <gab@chromium.org>
Reviewed-by: default avatardanakj <danakj@chromium.org>
Cr-Commit-Position: refs/heads/master@{#609066}
parent 8a9ca863
...@@ -217,20 +217,29 @@ different directories. For example, adding a parameter to a common function in ...@@ -217,20 +217,29 @@ different directories. For example, adding a parameter to a common function in
`//base`, with callers in `//chrome/browser/foo`, `//net/bar`, and many other `//base`, with callers in `//chrome/browser/foo`, `//net/bar`, and many other
directories. If the updates to the callers is mechanical, you can: directories. If the updates to the callers is mechanical, you can:
* Get a normal owner of the lower-level code you're changing (in this 1. Get a normal owner of the lower-level code you're changing (in this
example, the function in `//base`) to do a proper review of those changes. example, the function in `//base`) to do a proper review of those changes.
* Get _somebody_ to review the downstream changes made to the callers as a 2. Get _somebody_ to review the downstream changes made to the callers as a
result of the `//base` change. This is often the same person from the result of the `//base` change. This is often the same person from the
previous step but could be somebody else. previous step but could be somebody else.
* Add the owners of the affected downstream directories as TBR. (In this 3. TBR the owner of the lower-level code you're changing (in this example,
example, reviewers from `//chrome/browser/foo/OWNERS`, `//net/bar/OWNERS`, `//base`), after they've LGTM'ed the API change, to bypass owners review of
etc.) the API consumers incurring trivial side-effects.
This process ensures that all code is reviewed prior to checkin and that the This process ensures that all code is reviewed prior to checkin and that the
concept of the change is reviewed by a qualified person, but you don't have to concept of the change is reviewed by a qualified person, without having to ping
wait for many individual owners to review trivial changes to their directories. many owners with little say in the trivial side-effects they incur.
**Note:** The above policy is only viable for strictly mechanical changes. For
large-scale scripted changes you should:
1. Have an owner of the core change review the script.
2. Use `git cl split` to shard the large change into many small CLs with a
clear description of what each reviewer is expected to verify
([example](https://chromium-review.googlesource.com/1191225)).
#### Documentation updates #### Documentation updates
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment