CLIMADA Contribution Guide#

Thank you for contributing to CLIMADA!

Overview#

Before you start, please have a look at our Developer Guide.

To contribute follow these steps:

  1. Install CLIMADA following the installation instructions for developers.

  2. In the CLIMADA repository, create a new feature branch from the latest develop branch:

    git checkout develop && git pull
git checkout -b feature/my-fancy-branch

  3. Implement your changes and commit them with meaningful and well formatted commit messages.

  4. Add unit and integration tests to your code, if applicable.

  5. Use Pylint for a static code analysis of your code with CLIMADA’s configuration .pylintrc:

    pylint

  6. Add your name to the AUTHORS file.

  7. Push your updates to the remote repository:

    git push --set-upstream origin feature/my-fancy-branch

    NOTE: Only team members are allowed to push to the original repository. Most contributors are/will be team members. To be added to the team list and get permissions please contact one of the owners. Alternatively, you can fork the CLIMADA repository and add this fork as a new remote to your local repository. You can then push to the fork remote:

    git remote add fork <your-fork-url>
git push --set-upstream fork feature/my-fancy-branch

  8. On the CLIMADA-project/climada_python GitHub repository, create a new pull request with target branch develop. This also works if you pushed to a fork instead of the main repository. Add a description and explanation of your changes and work through the pull request author checklist provided. Feel free to request reviews from specific team members.

  9. After approval of the pull request, the branch is merged into develop and your changes will become part of the next CLIMADA release.

Resources#

The CLIMADA documentation provides a Developer Guide. Here’s a selection of the commonly required information:

Pull Requests#

After developing a new feature, fixing a bug, or updating the tutorials, you can create a pull request to have your changes reviewed and then merged into the CLIMADA code base. To ensure that your pull request can be reviewed quickly and easily, please have a look at the Resources above before opening a pull request. In particular, please check out the Pull Request instructions.

We provide a description template for pull requests that helps you provide the essential information for reviewers. It also contains a checklist for both pull request authors and reviewers to guide the review process.