Skip to content

Latest commit

 

History

History
86 lines (68 loc) · 2.86 KB

CONTRIBUTING.md

File metadata and controls

86 lines (68 loc) · 2.86 KB
Raw

How to contribute

Thank you for considering to contribute to our project! 🎉 👍

As a community-driven project we rely on the work and contribution of volunteers. By participating in this project, you agree to abide by the code of conduct.

In order to contribute you need to be registered on GitHub and familiar with the concepts of forking and communicating with GitHub.

We recommend to use Anaconda for your Python development.

Checklist

This checklist is closely based on a blog post by Davide Coppola. It also serves as a table of contents.

  1. Create a branch
  2. Work on your contribution
  3. Pull request
  4. Code review
  5. Clean up

Create a branch

Before your first contribution, make sure to fork the project.

Create a local branch to collect changes related to a new feature or bug fix. Branches help to organize different developments within the project and facilitate the code review process.

You can do that with the following git command:

$ git checkout -b BRANCH_NAME

This will create and checkout a new branch BRANCH_NAME in your local repository. It is best practice to use a name that clearly describes the purpose of the branch.

You can check which branch is active (*) using the git client:

$ git branch
  master
* BRANCH_NAME

Work on your contribution

Now you can start with the development of your new feature (or bug fix). You can commit changes as often as you like locally with:

$ git add FILENAME
$ git commit

Use git's commit and push mechanism to save and track your changes to your personal fork:

$ git push origin BRANCH_NAME

Pull request

After pushing your changes to your fork navigate to the GitHub page of your fork and create a Pull request. Add the needed information to the web form and submit your request.

Code review

The developer team will review your changes and decide whether to accept your changes. This process might include some discussion or even further changes to the code (this is the reason why branches are important).

Clean up

After your contribution has been merged to the main project (or rejected) you can delete your development branch:

$ git branch -D BRANCH_NAME  # local
$ git push origin --delete BRANCH_NAME  # server-side