Chrome LSC Workflow

This document describes the workflow for getting a large-scale change approved (Chrome LSC).

1 Complete the LSC template (link)

This short document will describe the large-scale change you want to make: What the change is, why you want to make it, estimated size (#CLs, #files), etc. Once you start sending out CLs, a link to that document should also be included in the description of each CL (more details at Chrome LSC Template).

For Googlers, if the details are Google-private, you can do the same thing but with your google.com account. Share comment access to google.com, in this case.

2 Request a domain review

Find a domain reviewer – someone who is knowledgeable in the area you are changing. Request a domain review for the LSC document you created in step 1 creating a document comment thread and assigning it to this person. The comment thread should include the instructions for the domain reviewer (briefly, if the domain reviewer approves the proposed LSC, they should add an “LGTM”, their name, and the date to top of the doc).

3 Wait for approval by lsc-review@

Once the domain review is complete, you should email the doc to lsc-review@chromium.org, who will review your LSC request. You should expect an initial response within two business days. How long it takes until the request is approved depends on how complex the change is and how much needs to be discussed; for simple changes, it should only take a few days. Final approval will be indicated by a member of the LSC committee granting a reviewer Owners-Override approval power to land your LSC. Put a link to the chromium.org lsc-review Group thread in the table at the top of the doc.

4 Start sending your CLs!

Once your LSC is approved (Owners-Override is granted) you may begin sending your CLs for review. You probably want to use git cl split to do this.

Questions

If at any point you have questions about this workflow, please contact lsc-policy@chromium.org and we'll be happy to help.