Contributions in any form are always welcome. If you think you have found a bug, you have an idea you think might improve things or even better you already have code and can make a pull request, do not hesistate to create an issue or make that pull request.
Nevertheless there are a couple of things to be aware of:
Setting up a development environment to work on Relief is fairly trivial. Nevertheless this is how you get started:
The first step is forking the repository on GitHub. Once you have done that you can clone your fork to create a local repository using:
$ git clone git@github.com:YourGitHubName/relief.git
Having done that you should probably create a virtual environment using virtualenv and activate it. If you don’t know what virtualenv is, you should learn about it before continuing, it is a very useful tool that you should be familiar with if you are doing anything serious in Python.
So once you have created your virtual environment and activated it, it is time to install all development tools and relief dependencies. You can do that by running:
$ make dev
This may take a while, once it is done you should have setup the development environment successfully. You can test that everything works by running:
$ make test
This will run all tests, all of which should pass.
You have no idea what to do now? Take a look at the open issues may be you will find an interesting challenge there.
We use pytest for testing, you can execute the tests with it using:
$ py.test
To test code and documentation on all supprted interpreters, we use tox, which is invoked like this:
$ tox
Like the technical community as a whole, the Relief team and community is made up of a mixture of professionals and volunteers from all over the world, working on every aspect of the missing - including mentorship, teaching and connecting people.
Diversity is one of our huge strengths, but it can also lead to communication issues and unhappiness. To that end, we have a few ground rules that we ask people to adhere to when they’re participating within this community and project. These rules apply equally to contributors and those seeking help.
This isn’t an exhaustive list of things you can’t do. Rather, take it in the spirit in which it’s intended - a guide to make it easier to enrich all of us and the technical communities in which we participate.
This code of conduct applies to all communication.
When we disagree, we try to understand why. Disagreements, both social and technical, happen all the time and Relief is no exception. It is important that we resolve disagreements and differing views constructively. Remember that we’re different. The strength of Relief comes from its varied community, people from a wide range of backgrounds. Different people have different perspective on issues. Being unable to understand why someone holds a viewpoint doesn’t mean that they’re wrong. Don’t forget that is is human to err and blaming each other doesn’t get us anywhere, rather offer to help resolving issues and to help learn from mistakes.
This text is a slightly modified version of the Speak Up! Code of Conduct which is available under a CC BY 3.0 license and was inspired by the Fedora Project and the Python Mentorship Project.