php-ml/CONTRIBUTING.md

51 lines
1.5 KiB
Markdown
Raw Normal View History

2016-07-26 19:57:15 +00:00
# Contributing to PHP-ML
PHP-ML is an open source project. If you'd like to contribute, please read the following text. Before I can merge your
Pull-Request here are some guidelines that you need to follow. These guidelines exist not to annoy you, but to keep the
code base clean, unified and future proof.
## Branch
You should only open pull requests against the `master` branch.
2016-07-26 19:57:15 +00:00
## Unit-Tests
Please try to add a test for your pull-request. You can run the unit-tests by calling:
```bash
vendor/bin/phpunit
2016-07-26 19:57:15 +00:00
```
## Travis
GitHub automatically run your pull request through Travis CI.
If you break the tests, I cannot merge your code, so please make sure that your code is working before opening up a Pull-Request.
2016-07-26 19:57:15 +00:00
## Merge
Please allow me time to review your pull requests. I will give my best to review everything as fast as possible, but cannot always live up to my own expectations.
## Coding Standards & Static Analysis
When contributing code to PHP-ML, you must follow its coding standards. To do that, just run:
```bash
vendor/bin/ecs check src tests --fix
```
[More about EasyCodingStandard](https://github.com/Symplify/EasyCodingStandard)
Code has to also pass static analysis by [PHPStan](https://github.com/phpstan/phpstan):
2016-07-26 19:57:15 +00:00
```bash
vendor/bin/phpstan.phar analyse src tests --level max --configuration phpstan.neon
```
2016-07-26 19:57:15 +00:00
## Documentation
Please update the documentation pages if necessary. You can find them in docs/.
2016-07-26 19:57:15 +00:00
---
Thank you very much again for your contribution!