Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.
If you have suggestions for how this project could be improved, or want to report a bug, open an issue! We'd love all and any contributions. If you have questions, too, we'd love to hear them.
We'd also love PRs. If you're thinking of a large PR, we advise opening up an issue first to talk about it, though! Look at the links below if you're not sure how to open a PR.
- Fork and clone the repository.
- Configure and install the dependencies:
npm install
. - Make sure the tests pass on your machine:
npm test
, note: these tests also apply the linter, so there's no need to lint separately. - Create a new branch:
git checkout -b my-branch-name
. - Make your change, add tests, and make sure the tests still pass.
- Commit your changes with message conforming to the Git Commit Messages guidelines.
- Push to your fork and submit a pull request.
- Pat your self on the back and wait for your pull request to be reviewed and merged.
Work in Progress pull requests are also welcome to get feedback early on, or if there is something blocking you.
- Write a descriptive commit message
- Use the present tense ("Add feature" not "Added feature")
- Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
- If you are fixing a GitHub issue, include something like 'Closes issue #xyz'
- For more best practices, read How to Write a Git Commit Message
In case of any question, contact us on the freenode.net IRC channel #leapp, or write the question as an issue on GitHub.