Fetching contributors…
Cannot retrieve contributors at this time
39 lines (21 sloc) 2.94 KB

Contributing to

We love pull requests!

To report a bug or simply help help communities, take a look through the following guide.

Reporting bugs and opening issues

To report a bug or open an issue, please follow the steps below:

  1. Find the correct repository. is split across multiple repositories, each containing a different service. If you know the bug only applies to one service/gem, please open an issue in that repository (a list is available here). For general bugs and issues that span more than one service/gem, please open an issue in the neighborly/neighborly repository.
  2. Check if there is an existing issue. If an issues already exists, please add any more information that you have, or give it a "+1" in the comments.
  3. Make sure that is related to If you open an issue that is not related to (e.g. a problem associated with git) we will simply close it.

When submitting an issue please describe the issue as clearly as possible, including how to reproduce the bug, which situations it appears in, what you expected to happen, and what actually happened. Screenshots for front-end issues are also very helpful.

Pull Requests

See our guides to get things done, programming well, and following our patterns. Make sure your code follows our style guide as well.

Add tests for your changes. Only refactoring and documentation changes require no new tests. If you are adding functionality or fixing a bug, we need a test! We will not accept pull requests of features without tests.

Again, we love pull requests, so don't be afraid to go ahead and change something or add a new feature. If they make sense, we're happy to work with you to get your changes merged into .

If you have an idea for a change, please discuss it in the open first, either by opening an issue, or by joining us in our development chat room.

Looking for something to work on? Take a look at our open issues.

Developer Chat Room

To ask a question in real-time or to get a feel for what's going on, please drop into our development chat room. If no one is online, you can still leave a message and we'll reply as soon as we return.


Please do not publish security vulnerabilities publicly until we've had a chance to address them. All security related issues/patches should be sent directly to where we will attempt to address them quickly. If you're unsure whether something is a security issue or not, please be cautious and contact us at first.

And in case we didn't emphasize it enough: we love tests!