Skip to content

Latest commit

 

History

History
73 lines (50 loc) · 3.5 KB

CONTRIBUTING.md

File metadata and controls

73 lines (50 loc) · 3.5 KB
Raw

How to Contribute

We'd love to accept your patches and contributions to this project. There are just a few small guidelines you need to follow.

GitHub issues

RabbitMQ Messaging Topology Kubernetes Operator team uses GitHub issues for feature development and bug tracking. The issues have specific information as to what the feature should do and what problem or use case is trying to resolve. Bug reports have a description of the actual behaviour and the expected behaviour, along with repro steps when possible. It is important to provide repro when possible, as it speeds up the triage and potential fix.

We do not use GitHub issues for questions or support requests. For that purpose, it is better to use RabbitMQ mailing list or RabbitMQ Slack #kubernetes channel.

For support questions, we strongly encourage you to provide a way to reproduce the behavior you're observing, or at least sharing as much relevant information as possible on the RabbitMQ users mailing list. This would include YAML manifests, Kubernetes version, RabbitMQ Operator logs and any other relevant information that might help to diagnose the problem.

Makefile

This project contains a Makefile to perform common development operation. If you want to build, test or deploy a local copy of the repository, keep reading.

Make targets

  • controller-gen Download controller-gen if not in $PATH

Testing

Before submitting a pull request, ensure all local tests pass

Pull Requests

RabbitMQ Operator project uses pull requests to discuss, collaborate on and accept code contributions. Pull requests are the primary place of discussing code changes.

Here's the recommended workflow:

  • Fork the repository or repositories you plan on contributing to. If multiple repositories are involved in addressing the same issue, please use the same branch name in each repository
  • Create a branch with a descriptive name
  • 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.
  • We will get to your pull request within one week. Usually within the next day or two you'll get a response.

If what you are going to work on is a substantial change, please first ask the core team for their opinion on the RabbitMQ users mailing list.

Code Conventions

This project follows the Kubernetes Code Conventions for Go, which in turn mostly refer to Effective Go and Go Code Review Comments. Please ensure your pull requests follow these guidelines.

Code reviews

All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests.

Community Guidelines

This project follows Contributor Covenant, version 2.0.