CONTRIBUTING.md 2.0 KB

Drupal Examples For Developers: Contributor's Guide

Examples for Developers is a community project.

If you'd like to participate in Examples development, thank you!

If you are new to Drupal or open source in general, have no fear. Examples is an easy-going project where you can learn some things about how to work on a collaborative project in a friendly environment.

Policies

Examples follows the Drupal core process as much as possible.

Contributions thus need to be similar in quality to Drupal core patches. Contributions will need to meet the following minimum standards:

Normal Drupal issue process

Drupal projects use patches related to issues. You should know how to make a patch and an interdiff using git. It's fine to develop on github or what-have-you, but eventually it has to be a patch that can be reviewed in the normal Drupal issue process. See the list of resources for some information on how to do do this.

Your patch will also need to be reviewed by someone other than yourself. Learn about the review process in the resources section.

DrupalCI

Examples uses the Drupal automated testing system to verify the applicability of patches. See TESTING.md for details.

Drupal coding standards

All code in Examples should adhere to the Drupal core coding standards. Examples uses the Drupal Coder project and PHP_CodeSniffer to enforce coding standards. Think of this as another test your code must pass. See STANDARDS.md for details.

Resources

Novice

Drupal novice contribution guide: https://www.drupal.org/novice

Drupal contribution guide: https://www.drupal.org/contribute

What's a patch? https://www.drupal.org/patch

How to make a patch with git: https://www.drupal.org/node/707484

Everyone

How to review a patch: https://www.drupal.org/patch/review

See STANDARDS.md and TESTING.md for information on how to run a coding standards test, and also how to run the tests themselves.