Contributing to RoaringRoster

Thank you for your interest in contributing to RoaringRoster. 🙌

Report an Issue

If you have found an unknown bug or want to suggest a feature, please open a new issue in the GitHub issue tracker.

In case of a bug, please indicate the individual steps to reproduce the bug. What result did you expect and what happened instead? It is also important for us to know with which operating system version and in which browser including version number you observed the problem.

If you have discovered a security vulnerability, please report it to us confidentially via email to security@roaringroster.app instead of opening an issue.

Contribute Code

Please start by proposing new features or bugfixes in a GitHub issue to make sure it fits the direction of the project. Assign the issue to yourself and let people know when you start or stop work to avoid duplication or unfinished tasks.

Please note that we ask you to read and accept our Contributor License Agreement so we can approve your contribution. You can find more information in the related section below.

Start by forking the repository and make your changes.

After you have opened a pull request with your changes and accepted the Contributor License Agreement, your code changes will be reviewed for approval. We will merge them on approval. Pease be aware that contributions that do not fit the project will not be approved.

Contributor License Agreement (CLA)

Why anyway?

What is this about?

Please read our Individual Contributor License Agreement. This is a legally binding document that documents the rights granted by you to us.

A roughly simplified overview:

How is the process?

  1. Start by creating a pull request with your contribution on GitHub.
  2. You will automatically be presented our Individual Contributor License Agreement. Please read it.
  3. To make this document effective, please sign the agreement by typing “I have read the CLA Document and I hereby sign the CLA” as additional comment to your pull request.

Your signature will be automatically documented with the date and your Github name in a file inside the same repository.

  1. Any other author of the contribution should also sign the Contributor License Agreement as described in the previous answer.
  2. Please let us know if you do not own the copyright to your entire contribution, either as a comment in your pull request or by email to cla@roaringroster.app.
Are you an employee and have you created your contribution as part of your employment?

Please have your employer approve the Corporate Contributor License Agreement, which has the same terms as the Individual Contributor License Agreement, but addresses legal entities such as companies:

  1. To make this document effective, a legal representative of your employer needs to print, fill, sign, scan the Corporate CLA and email the signed copy to us at cla@roaringroster.app.
  2. We will do the same and return a copy signed by both parties to your employer.
  3. Additionaly, you as individual contributor need to sign the Individual Contributor License Agreement with your pull request on GitHub as described in the previous two answers.