CONTRIBUTING.md

How to become a contributor and submit your own code

Contributor License Agreements

We'd love to accept your patches! Before we can take them, we have to jump a couple of legal hurdles.

Please fill out either the individual or corporate Contributor License Agreement (CLA).

Follow either of the two links above to access the appropriate CLA and instructions for how to sign and return it. Once we receive it, we'll be able to accept your pull requests.

Contributing A Patch

  1. Submit an issue describing your proposed change to the issue tracker.
  2. Please don't mix more than one logical change per submittal, because it makes the history hard to follow. If you want to make a change that doesn't have a corresponding issue in the issue tracker, please create one.
  3. Also, coordinate with team members that are listed on the issue in question. This ensures that work isn't being duplicated and communicating your plan early also generally leads to better patches.
  4. If your proposed change is accepted, and you haven't already done so, sign a Contributor License Agreement (see details above).
  5. Fork the desired repo, develop and test your code changes.
  6. Ensure that your code adheres to the existing style in the sample to which you are contributing.
  7. Ensure that your code has an appropriate set of unit tests which all pass.
  8. Submit a pull request.

If you are a Googler, it is preferable to first create an internal change and have it reviewed and submitted, and then create an upstreaming pull request here.



google/patrick documentation built on April 13, 2025, 4:01 p.m.