Contributing to EasyReact
We love contributions to the EasyReact project and request you follow the guidelines below. If you have any questions, or need any help, contact us on EasyReact Team.
Table of Contents
- Contributing to EasyReact
To get started, you will need to open a Terminal and:
Fork this repo and clone it onto your machine.
$ git clone https://github.com/YOUR_GITHUB_ID/EasyReact
Make changes to code, usually by tackling an issue. A list of issues can be found ISSUE.
If there aren't any tagged issues, mail to EasyReact Team. and the team would be happy to help you get started.
All source code submitted requires an Apache License header at the top of the file. This text can be found Here, just copy and paste it at the top of any new files you're submitting.
Ensure all tests pass with your changes and test coverage must greater than before. If there is any new functionality introduced by your changes, new test case(s) may be required. If you need any help writing tests, contact us on EasyReact Team.
Commit message should conform to commit message templates.
If the tests all pass, open a Pull Request following the guidelines below.
Note: Before opening a Pull Request, please run the tests and check them all pass and keep test coverage greater than or equal before.
EasyReact uses Continuous Integration. You may see mentions of Travis CI in your PR and its comments. Travis is an external service we use that is automatically called on every PR, and runs the test cases on macOS and iPhone simulator to ensure every code change is stable.
To open a new Pull Request, the GitHub website provides the simplest experience for new users. Go to your fork of the repo and click the New pull request button. You will be presented with a page featuring base fork: and base:, then an arrow, and then head fork: compare:. Make sure compare: has your branch with your changes selected and base: has master selected. When you are ready to open the PR, click the green button at the top called Create pull request.
When opening a PR, please:
- Create minimal differences and do not reformat the code. If you feel the codes structure needs changing, open a separate PR.
- Check for unnecessary white space using
git diff --checkbefore you commit your code.
If you have any questions, mail to EasyReact Team. Comment on existing issues, or raise new ones if you discover something.
See the issue template.