media3/CONTRIBUTING.md
ibaker f799766db5 Document style guide and google-java-format in CONTRIBUTING.md
Prompted by discussion on this commit: e8117496e0

#minor-release

PiperOrigin-RevId: 524795901
2023-04-17 17:17:04 +01:00

2.5 KiB

How to contribute

Reporting issues

We use the AndroidX Media issue tracker to track bugs, feature requests and questions.

Before filing a new issue, please search the trackers to check if it's already covered by an existing report. Avoiding duplicates helps us maximize the time we can spend fixing bugs and adding new features. You will also find older issues on our ExoPlayer GitHub issue tracker.

When filing an issue, be sure to provide enough information for us to efficiently diagnose and reproduce the problem. In particular, please include all of the information requested in the issue template.

Pull requests

We will also consider high quality pull requests. These should merge into the main branch. Before a pull request can be accepted you must submit a Contributor License Agreement, as described below.

Code style

We follow the Google Java Style Guide and use google-java-format to automatically reformat the code. Please consider auto-formatting your changes before opening a PR (we will otherwise do this ourselves before merging). You can use the various IDE integrations available, or bulk-reformat all the changes you made on top of main using google-java-format-diff.py:

$ git diff -U0 main... | google-java-format-diff.py -p1 -i

Contributor license agreement

Contributions to any Google project must be accompanied by a Contributor License Agreement. This is not a copyright assignment, it simply gives Google permission to use and redistribute your contributions as part of the project.

  • If you are an individual writing original source code and you're sure you own the intellectual property, then you'll need to sign an individual CLA.

  • If you work for a company that wants to allow you to contribute your work, then you'll need to sign a corporate CLA.

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.