Skip to content

Contributing to Gradle#

As in any open-source project, contributions to Gradle are welcome! Gradle Build Too itself, its documentation, many plugins and tools within Gradle's ecosystem are open-source, and you can contribute anywhere. See the links on the left for particular contributing guidelines.

For Newcomers#

If you are a newcomer contributor, note that Gradle has a quite steep learning curve. As the foundational developer tool used by millions, there are high expectations about stability and maintainability of the submitted code and documentation. The main gradle/gradle has quite strict rules and requirements, and it may take a while till your changes are merged and released.

If you are just starting your journey in open source and do not aim fixing a specific issue impacting you, iut is highly recommended to start from plugins and smaller repositories where the entry bar is much lower.

Key Channels#

Community Slack#

We have a community Slack on the gradle-community workspace. This is a main channel for Q&A and quick discussions.

  • Join the Community Slack
  • Use the #contributing channel if you need any help with contributing changes to gradle and getting them over the line.
  • We have a searchable Slack archive here.

Learn more about Slack and the communication best practices on this page.

Gradle Forums#

We run Gradle Forums on Discourse: discuss.gradle.org. This channel is designed for long-term conversations, e.g. project and architecture proposals.

GitHub#

We use GitHub Issues and Projects to cooperate. You may find GitHub Issues on all public repositories. For the Gradle Build Tool as whole, we use issues in the main gradle/gradle repository.

Quick links:

  • Good First Issues - Issues for newcomers who just start contributing to Gradle
  • Help Wanted - Issues for more experienced contributors that are open for grabs

At the moment we do not have GitHub Discussions and Wiki in the main repositories, most of the discussions are expected to happen in GitHub Issues. Other repositories may offer different discussion channels.

Resources#