Contributing to Adoptium®

Thanks for your interest in this project.

Project description

Adoptium is an open-source project that focuses on providing high-quality, production-ready distributions of the Java Development Kit (JDK) and associated technologies. The project’s main goal is to create a vendor-neutral, community-driven distribution of OpenJDK, which is the open-source implementation of the Java Platform, Standard Edition (Java SE).

Adoptium aims to provide users with reliable and well-tested builds of OpenJDK across different platforms, including Windows, macOS, Linux, and more. The project collaborates closely with the OpenJDK community and benefits from the expertise of a diverse group of contributors, including developers, organizations, and Java enthusiasts.

One of the key objectives of Adoptium is to make it easier for developers and organizations to access and consume OpenJDK builds. It provides prebuilt binaries that are thoroughly tested, ensuring stability and compatibility. These binaries are available for free, making it convenient for developers to adopt and use OpenJDK in their projects without any licensing restrictions.

Adoptium also offers long-term support (LTS) builds, which are specifically designed for enterprises and organizations that require a stable and reliable Java runtime environment. The LTS builds receive regular updates and security patches, ensuring the longevity and maintenance of the Java platform.

Overall, Adoptium aims to provide a trustworthy and accessible distribution of OpenJDK, promoting transparency, collaboration, and community-driven innovation within the Java ecosystem.

Developer resources

The Adoptium project maintains the following source code repositories:

Eclipse Contributor Agreement

Before your contribution can be accepted by the project team contributors must electronically sign the Eclipse Contributor Agreement (ECA).

Commits that are provided by non-committers must have a Signed-off-by field in the footer indicating that the author is aware of the terms by which the contribution has been provided to the project. The non-committer must additionally have an Eclipse Foundation account and must have a signed Eclipse Contributor Agreement (ECA) on file.

For more information, please see the Eclipse Committer Handbook and Adoptium documentation:

Submitting a contribution to Adoptium

After signing the ECA, you can propose contributions by sending pull requests (PRs) through GitHub. Pull requests should be accompanied by a GitHub issue that documents the problem or feature that the change is addressing. The Eclipse Adoptium project uses the Agile methodology for planning and developing fixes and new features, the Adoptium Agile Guidelines documents what is required for GitHub issues and contributions.

Note: Assume we are contributing to the aqa-tests repo

If this is your first time contributing to the project, fork the repo by clicking on the Fork button in the top-right corner of the git repo page. This creates a copy of the repo under your GitHub account: https://github.com/<YourGitUserName>/aqa-tests.git

Git clone the your repo:

git clone https://github.com/<YourGitUserName>/aqa-tests.git

Create a new branch to work on:

cd aqa-tests
git checkout -b my_new_branch
git remote add upstream https://github.com/adoptium/aqa-tests.git

Before you start working on the issue, plese make sure the local branch is up to date:

git fetch upstream
git rebase upstream/master

Once you are done with your work, track your changes and commit.

git add .
git commit -s -m "message about this PR"

  • Commit message example:

Update jtreg in openjdk test
This patch updates jtreg version from 5.1 to 6.1.
Fixes: #1234
Signed-off-by: Full Name <email>

  • The first line is the PR title. It should describe the change made. Please keep it short and simple.

  • The body should include detailed information about your PR. You may want to include designs, rationale, and a brief explanation of what you have changed. Please keep it concise.

  • When a commit has related issues, please use the Git keywords to automatically close or relate to the issues. https://help.github.com/articles/closing-issues-using-keywords/

  • Please sign off on your commit in the footer. This can be automatically added to your commit by passing -s to git commit (see above example).

Push the change into your Git repo:

git push origin my_new_branch

  • You can use -f in git push if need to overwrite your git history. Please use this flag with caution.

We would like to encourage you to open a pull request early and use the Create draft pull request option. This allows others to check the PR, get early feedback, and helps create a better end product.

If you have been given access to run test jobs in our Jenkins server, run Grinder to validate your PR. If you do not have access, the reviewers of your PR will run some tests. Reviewers may ask you to run extra tests depending on what changes you have made in your PR.

Ensure all related Grinder jobs pass and provide the Grinder links in the PR comment. Your changes must also pass the auto PR builds that will be applied to your pull request.

Convert PR to Ready for review once the PR is ready.

Contact

Contact the Eclipse Foundation Webdev team via webdev@eclipse-foundation.org.

DOCUMENTATION AUTHORS
  • Ndacyayisenga-droid
  • andrew-m-leonard
Help us make these docs great!
All Adoptium docs are open source. See something that's wrong or unclear?
Edit this page