CONTRIBUTE.md

Contributors guide

Want to contribute? Great! We try to make it easy, and all contributions, even the smaller ones, are more than welcome. This includes bug reports, fixes, documentation, examples... But first, read this page (including the small print at the end).

Legal

All original contributions to to be continuous are licensed under the GNU Lesser General Public License, version 3.0 or later.

All contributions are subject to the Developer Certificate of Origin (DCO). The DCO is a lightweight way for contributors to certify that they wrote or otherwise have the right to submit the code they are contributing to the project. The DCO text is also included verbatim in the DCO.txt file in the root directory of the repository.

Contributors must sign-off that they adhere to these requirements by adding a Signed-off-by line to commit messages, as shown below:

This is the commit message

Signed-off-by: John Dev <john.dev@developer.example.org>

Git has a handy -s command line option to append this automatically to your commit message:

$ git commit -s -m 'This is the commit message'

Reporting an issue

This project uses GitLab issues to manage the issues.

Before creating an issue:

1. upgrade your project to the latest released template version, and check whether your bug is still present,
2. have a look in the opened issues if your problem is already known/tracked, and possibly contribute to the thread with your own information.

If none of the above was met, open an issue directly in GitLab, select the appropriate issue template and fill-in each section when applicable.

Submitting a code change

Git Setup

Before contributing, make sure you have set up your Git authorship correctly:

git config --global user.name "Your Full Name"
git config --global user.email your.email@example.com

Workflow

All submissions, including submissions by project members, need to be reviewed before being merged.