Thank you for considering and taking the time to contribute!
The following are guidelines for contributing to this project.
Code of Conduct
How to Get Started
Please refer to installation and build instructions in the documentation.
How to Report Bugs
Please open a new issue in the GitHub repository with steps to reproduce the problem you're experiencing.
Be sure to include as much information including screenshots, text output, and both your expected and actual results.
If you believe that you've found a security vulnerability, please report it by sending email to the addresses: firstname.lastname@example.org and email@example.com
How to Request Enhancements
Then, please create a new issue in the GitHub repository describing your enhancement.
Be sure to include as much detail as possible including step-by-step descriptions, specific examples, screenshots or mockups, and reasoning for why the enhancement might be worthwhile.
Please keep in mind, by opening an issue we provide no guarantee the enhancement will be implemented.
How to Contribute Code
Before you get started writing code, be sure what you plan to work on is something we'll be able to accept. The easiest way is to look through out list of good first issues and find something that sounds interesting.
If there's something else you'd like to work on, just add a comment in the relevant issue and we'll be happy to discuss your plans. If you have an idea that doesn't have an issue at all, be sure to file an issue first.
Once you have a patch ready:
- Make sure all tests are passing and try to add tests for the code you've written. You can run tests in XCode by selecting the
uispecstarget and hitting CMD-U.
- Submit a pull request! From there, we'll guide you through the review process to the eventual landing of your code. We aim to respond to all review requests within two business days.