Skip to content

Latest commit

 

History

History
29 lines (22 loc) · 2.63 KB

CONTRIBUTING.md

File metadata and controls

29 lines (22 loc) · 2.63 KB

Contributing to Open Liberty

Anyone can contribute to the Open Liberty project and we welcome your contributions!

There are multiple ways to contribute: report bugs, fix bugs, contribute code, improve upon documentation, etc. You must follow these guidelines:

Raising issues

Please raise any bug reports on the Open Liberty project repository's GitHub issue tracker. Be sure to search the list to see if your issue has already been raised.

A good bug report is one that make it easy for everyone to understand what you were trying to do and what went wrong. Provide as much context as possible so we can try to recreate the issue.

Contributor License Agreement

If you are contributing code changes via a pull request, you must signoff on the Contributor License Agreement. Instructions how to sign and submit the agreement are here: https://github.com/OpenLiberty/open-liberty/blob/master/cla/open-liberty-cla-individual.pdf.

After we obtain the signed CLA, you are welcome to open a pull request, and the team will be notified for review. We ask you follow these steps through the submission process.

  1. Ensure you run a passing local gradle build explained in the README before opening a PR.
  2. Open PR's against the "integration" branch, as we ensure changes pass our series of verification buckets before pushing to master.
  3. A label should be added "CLA signed" if your github id is registered with our project.
  4. A team of "reviewers" will be notified, will perform a review, and if approved will invoke a full integration build.
  5. Based on the results of the build, and if further review is needed, more discussion will occur.
  6. If the reviewer is satisfied with the results, and agrees to the change, the PR will be merged to integration, otherwise the PR will be closed with an explaination and suggestion for followup.

Coding Standards

Please ensure you follow the coding standards used throughout the existing code base. Some basic rules include:

  • all files must have a Copyright including EPL license in the header.
  • all PRs must have a passing build.