RabbitMQ projects use pull requests to discuss, collaborate on and accept code contributions. Pull requests is the primary place of discussing code changes.
The process is fairly standard:
- Fork the repository or repositories you plan on contributing to
- Clone RabbitMQ umbrella repository
cd umbrella
,make co
- Create a branch with a descriptive name in the relevant repositories
- Make your changes, run tests, commit with a descriptive message, push to your fork
- Submit pull requests with an explanation what has been changed and why
- Submit a filled out and signed Contributor Agreement if needed (see below)
- Be patient. We will get to your pull request eventually
If what you are going to work on is a substantial change, please first ask the core team of their opinion on RabbitMQ mailing list.
See CODE_OF_CONDUCT.md.
To run a "fast suite" (a subset of tests):
make ct-fast
To run a "slow suite" (a subset of tests that take much longer to run):
make ct-slow
To run a particular suite:
make ct-$suite_name
for example, to run the backing_queue
suite:
make ct-backing_queue
Finally,
make tests
will run all suites.
If you want to contribute a non-trivial change, please submit a signed copy of our Contributor Agreement around the time you submit your pull request. This will make it much easier (in some cases, possible) for the RabbitMQ team at Pivotal to merge your contribution.
If something isn't clear, feel free to ask on our mailing list.