grpc-java/CONTRIBUTING.md

1.7 KiB

How to submit a bug report

If you received an error message, please include it and any exceptions.

We commonly need to know what platform you are on:

  • JDK/JRE version (i.e., java -version)
  • Operating system (i.e., uname -a)

How to contribute

We definitely welcome patches and contributions to grpc! Here are some guideline and information about how to do so.

Before getting started

In order to protect both you and ourselves, you will need to sign the Contributor License Agreement.

We follow the Google Java Style Guide. Our build automatically will provide warnings for style issues. Eclipse and IntelliJ style configurations are commonly useful. For IntelliJ 14, copy the style to ~/.IdeaIC14/config/codestyles/, start IntelliJ, go to File > Settings > Code Style, and set the Scheme to GoogleStyle.

If planning on making a large change, feel free to create an issue on GitHub, visit the #grpc IRC channel on Freenode, or send an email to grpc-io@googlegroups.com to discuss beforehand.

Proposing changes

Make sure that ./gradlew build (gradlew build on Windows) completes successfully without any new warnings. Then create a Pull Request with your changes. When the changes are accepted, they will be merged or cherry-picked by a gRPC core developer.