libretime/CONTRIBUTING.md

1.9 KiB

Contributing to LibreTime

First and foremost, thank you! We appreciate that you want to contribute to LibreTime, your time is valuable, and your contributions mean a lot to us.

What does "contributing" mean?

Creating an issue is the simplest form of contributing to a project. But there are many ways to contribute, including the following:

  • Updating or correcting documentation
  • Feature requests
  • Bug reports

Before opening an issue, please:

For bug reports, please provide the following details:

  • version: what version of LibreTime you were using when you experienced the bug?
  • distro: what distribution is your install on and which distro version are you using (ie. Ubuntu Trusty)
  • reduced test case: the minimum amount of detail needed to reproduce the bug
  • error messages: please paste any error reports into the issue or a gist

Please wrap all code and error messages in markdown code fences.

Contributing code

To make sure that you don't accidentally commit code that does not follow the coding style, you can install a pre-commit hook that will check that everything is in order:

pre-commit install

You can also run it anytime using:

pre-commit run --all-files