Last updated 13 December 2017.

Want to contribute code to Drupal? Welcome! This section contains what you’ll need to know, how the process works, and how to get help along the way.

What You Need to Know

If you have a basic understanding of Drupal and coding in PHP, you’re ready to begin. If not, there are several equally awesome ways to contribute that don’t involve coding. You’ll also need to know a little about git, so make sure it’s installed on your system and the documentation should guide you on what you’ll need in order to submit a patch.

So How Does This Work?

Glad you asked. Let’s give a quick overview, then we’ll go into the details. First, we’ll pick an issue to work on. Choosing one of the issues tagged "Novice" should make the initial experience a little easier. Then, we’ll set up an environment and work on the issue. After that, we’ll create a patch and attach it to the issue. We’ll set it to be reviewed, and a testbot will come out of nowhere and run tests with your patch. If the patch "passes", a member of the community will then review the patch. If the patch is approved by a community member(s), a code maintainer will submit the patch to the code base, and the issue will be marked fixed.

patch process

Now, part of the awesomeness of Drupal is that there are coding standards, tests, and community reviews. It keeps the code consistent and the quality high. So, if you are asked to submit a patch a couple of times, keep calm and submit it again. It’s a great way to learn from your peers. Soon you’ll be doing the same for other novice contributors.

Now that you know how it works, let’s get started.