# Contributing to Perfetto
This project uses [Android AOSP Gerrit][perfetto-gerrit] for code reviews,
uses the [Google C++ style][google-cpp-style] and targets `-std=c++11`.

Development happens in this repo:
https://android.googlesource.com/platform/external/perfetto/

## Contributor License Agreement

Contributions to this project must be accompanied by a Contributor License
Agreement. You (or your employer) retain the copyright to your contribution;
this simply gives us permission to use and redistribute your contributions as
part of the project. Head over to <https://cla.developers.google.com/> to see
your current agreements on file or to sign a new one.

You generally only need to submit a CLA once, so if you've already submitted one
(even if it was for a different project), you probably don't need to do it
again.

## Code Reviews

All submissions, including submissions by project members, require review.
We use [Android AOSP Gerrit][perfetto-gerrit] for this purpose.

`git cl upload` from [Chromium depot tools][depot-tools] is the preferred
workflow to upload patches, as it supports presubmits and code formatting via
`git cl format`.

## Continuous integration

Continuous build and test coverage is available at
[ci.perfetto.dev](https://ci.perfetto.dev).

**Trybots**:  
CLs uploaded to Gerrit are automatically submitted to the CI and
and available on the CI page.
If the label `Presubmit-Ready: +1` is set, the CI will also publish a comment
like [this][ci-example] on the CL.

## Community

You can reach us on our [Discord channel](https://discord.gg/35ShE3A).
If you prefer using IRC we have an experimental Discord <> IRC bridge
synced with `#perfetto-dev` on [Freenode](https://webchat.freenode.net/).

This project follows
[Google's Open Source Community Guidelines](https://opensource.google/conduct/).

[perfetto-gerrit]: https://android-review.googlesource.com/q/project:platform%252Fexternal%252Fperfetto+status:open
[google-cpp-style]: https://google.github.io/styleguide/cppguide.html
[depot-tools]: https://dev.chromium.org/developers/how-tos/depottools
[ci-example]: https://android-review.googlesource.com/c/platform/external/perfetto/+/1108253/3#message-09fd27fb92ca8357abade3ec725919ac3445f3af