Contributing

March 1, 2021 ยท View on GitHub

Contributions are welcome and will be fully credited.

We accept contributions via pull requests on Github. Please make all pull requests to the develop branch, not the master branch.

Before posting an issue

  • If a command is failing, post the full output you get when running the command, with the --verbose argument
  • If everything looks normal in said log, provide a log without the --force argument

Pull Requests

  • Create an issue - Explain as detailed as possible the issue you encountered so we can understand the context of your pull request
  • Symfony Coding Standard - The easiest way to apply the conventions is to run composer lint
  • Add tests! - Your patch won't be accepted if it doesn't have tests.
  • Document any change in behaviour - Make sure the README.md and any other relevant documentation are kept up-to-date.
  • Consider our release cycle - We try to follow SemVer v2.0.0. Randomly breaking public APIs is not an option.
  • Create feature branches - Don't ask us to pull from your master branch.
  • One pull request per feature - If you want to do more than one thing, send multiple pull requests.
  • Send coherent history - Make 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.

Building the PHAR

Once you cloned the repository in local, in order to test your changes, one solution :

  • You can compile the PHAR by doing composer build which will output to bin/wsdltophp.phar. In order to compile it you'll need to have the phar.readonly set to Off in your php.ini.

Running Tests

$ composer test

Happy coding!