Skip to content

Contributing to Gradle#

As in any open-source project, contributions to Gradle are welcome! Gradle Build Tool itself, its documentation, many plugins and tools within Gradle's ecosystem are open-source, and you can contribute anywhere. Regardless of how much time you can dedicate and your level of expertise, there are opportunities to contribute!

See the links on the left for particular contributing guidelines.

Types of Contribution#

For Newcomers#

If you are a newcomer contributor, note that Gradle Build Tool and core plugins (components under gradle/gradle) have 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. 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, it is highly recommended to start from plugins and smaller repositories where the entry bar is much lower.

Key Communication 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 want to 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#