Contributing guidelines
Testing
To ensure all code changes adhere to existing code quality standards, some automatic checks can be run locally.
Ensure that the code builds without warnings and passes the tests:
And also run the linter on your code:
Build the documentation and check if you get any warnings:
Submitting changes
Clone the repository or pull the latest changes to your local repository by running:
Create a new branch to work on:
After finishing your work commit your changes with
If it is a big changeset you can create multiple commits. Now you can generate a set of patches, that represents the difference between branch-name-with-my-changes
and master
:
This command creates a patch for each commit and saves them in the current directory. The patches are numbered sequentially, their filenames contain the the first line of the commit message and their extension is .patch
.
Contact
Contributions are very welcome. Send your bug reports, feature requests, questions and patches to belka@caraus.de or open an issue here. Patches can be attached to existing issues, otherwise feel free to create a new one.