Contributing
Welcome to the contribution guide for Factory Muffin. Contributions are welcome, and are accepted via pull requests. Please review these guidelines before submitting any pull requests.
Which Branch?
- Please submit all pull requests for new features to the master branch.
- Please submit pull requests for bug fixes and typos to the earliest branch the issue can be found in.
Guidelines
- Please follow the PSR-2 Coding Standard and PHP-FIG Naming Conventions.
- Ensure that the current tests pass, and if you've added something new, add the tests where relevant.
- Remember that we follow SemVer. If you are changing the behaviour, or the public api, you may need to update the docs.
- Send a coherent commit history, making sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.
- You may also need to rebase to avoid merge conflicts.
Running Tests
You will need an install of Composer before continuing.
First, install the dependencies:
$ composer install
Then run phpunit:
$ vendor/bin/phpunit
If the test suite passes on your local machine you should be good to go.
When you make a pull requests the tests will automatically be run again by Travis CI on multiple php versions and hhvm.