Project: Infinispan (App Definition and Development / Database)
File: CONTRIBUTING.md

Guidelines for contributing to Infinispan ==== Contributions from the community are essential in keeping Infinispan strong and successful. This guide focuses on how to contribute back to Infinispan using GitHub pull requests. If you need help with cloning, compiling or setting the project up in an IDE please refer to our . All original contributions to Infinispan are licensed under the , version 2.0 or later, or, if another license is specified as governing the file or directory being modified, such other license. All contributions are subject to the . The DCO text is also included verbatim in the file in the root directory of the repository. If you are just getting started with Git, GitHub and/or contributing to Infinispan there are a few prerequisite steps: Make sure you have a the Infinispan . As discussed in the linked page, this also includes: up your local git install Cloning your fork If you have opened a JIRA issue but are not comfortable enough to contribute code directly, creating a self contained test case is a good first step towards contributing. Just fork the repository, build your test case and attach it as an archive to a JIRA issue. Create a "topic" branch on which you will work. The convention is to name the branch using the JIRA issue key. If there is not already a JIRA issue covering the work you want to do, create one. Assuming you will be working from the main branch and working on the JIRA ISPN-8760: ```shell git checkout -b ISPN-8760 main ``` Code away... The Infinispan family projects share the same style conventions. Please refer to our for more details. If you need to debug a test running inside a container, such as the tests in `server/tests`, you will need to start a debugger in listening/server mode on port 5005. Set any breakpoints you need and then launch the test with the `org.infinispan.test.server.container.debug` system property set to the index of the container you want to debug (usually `0` for the first container): ``` mvn verify -pl server/tests -Dit.test=RequestTracingIT -Dorg.infinispan.test.server.container.debug=0 ``` Make commits of logical units. Be sure to start the commit messages with the JIRA issue key you are working on. This is how JIRA will pick up the related commits and display them on the JIRA issue. Avoid formatting changes to existing code as much as possible: they make the intent of your patch less clear. Make sure you have added the necessary tests for your changes. Run all the tests to assure nothing else was accidentally broken: ```shell mvn verify ``` _Prior to committing, if you want to pull in the latest upstream changes (highly appreciated by the way), please use rebasing rather than merging (see instructions below). Merging creates "merge commits" that really muck up the project timeline._ Add the original Infinispan repository as a remote repository called upstream: ```shell git remote add upstream git@github.com:infinispan/infinispan.git ``` If you want to rebase your branch on top of the main branch, you can use the following git command: ```shell git pull --rebase upstream main ``` Push your changes to a topic branch in your fork of the repository. Initiate a . Update the JIRA issue, using the "Link to pull request" button to include a link to the created pull request.