Skip to content

Guidelines

Drush is built by people like you! Please join us.

Git and Pull requests

  • Contributions are submitted, reviewed, and accepted using GitHub pull requests.
  • The latest changes are in the 15.x branch. PR's should initially target this branch.
  • See the test-specific README.md for instructions on running the test suite. Test before you push. Optionally run tests in the provided Docker containers.
  • We maintain branches named 15.x, 13.x, etc. These are release branches. From these branches, we make new tags for patch and minor versions.

Development Environment

Coding style

  • Do write comments. You don't have to comment every line, but if you come up with something that's a bit complex/weird, just leave a comment. Bear in mind that you will probably leave the project at some point and that other people will read your code. Undocumented huge amounts of code are nearly worthless!
  • We use PSR-12.
  • Keep it compatible. Do not introduce changes to the public API, or configurations too casually. Don't make incompatible changes without good reasons!
  • Run composer cs to check the project for coding style issues and run composer cbf to fix them automatically where possible. These scripts use PHP_CodeSniffer in background.

Documentation

  • The docs are on our web site.
  • The site is built with Zensical. To preview it, run composer mk:docs to generate the command pages, install Zensical in a virtual environment (python3 -m venv .venv && .venv/bin/pip install zensical; needs Python 3.11+), then run .venv/bin/zensical serve.
  • Documentation should be kept up-to-date. This means, when you add or change a command, option, or event, update the docs in the same pull request.