I'm open to, and grateful for, any contributions you make. By contributing to Temper, you agree to abide by the Code of Conduct.
Reporting Issues and Asking Questions
Before opening an issue, please search the issue tracker to make sure your issue hasn't already been reported.
Bugs and Improvements
I use the issue tracker to keep track of bugs and improvements to Temper. I encourage you to open issues to discuss improvements, architecture, theory, internal implementation, etc. If a topic has been discussed before, you will be asked to join the previous discussion.
I actively welcome your pull requests.
- Fork the repo and create your branch from
- If you've added code that should be tested, add tests.
- If you've changed APIs, update the documentation.
- Ensure the test suite passes.
- Make sure your code lints and is formatted with
yarn formatto run
prettieron all files.
- If you haven't already, read the Code of Conduct.
Please file issues liberally. That's the easiest way to contact me. I'm eager for your questions, input, and to hear about your experience.
Help Me Help You
It is a good idea to structure your code and question in a way that is easy to read to entice people to answer it. For example, I encourage you to use syntax highlighting, indentation, and split text in paragraphs.
Please keep in mind that people spend their free time trying to help you. You can make it easier for them if you provide versions of the relevant libraries and a runnable small project reproducing your issue. You can put your code on JSBin or, for bigger projects, on GitHub. Make sure all the necessary dependencies are declared in
package.json so anyone can run
npm install && npm start and reproduce your issue.
master Branch is Unsafe
I will do my best to keep master in good shape, with tests passing at all times. But I will sometimes make API changes that your application might not be compatible with. I will do my best to communicate these changes and always version appropriately so you can lock into a specific version if need be.
By contributing to Temper, you agree that your contributions will be licensed under the MIT license.