CONTRIBUTING.md

How to contribute

We welcome everyone to submit pull requests with:

• fixes for issues
• change suggestions
• updating of documentation

NOTE: Pull requests are not automatically accepted.

Coding standards

You MUST use the following coding standards:

• PSR-1
• PSR-2
• PSR-4

We use StyleCI to ensure these coding standards are consistently achieved.

Documentation

You SHOULD update any relevant documentation.

Making changes

You MUST do the following:

• Write commit messages that make sense and in past tense.
• Write (or update) unit tests.
• Run composer test and ensure everything passes.

We use Travis and Code Climate to help us achieve successful unit testing, code quality, and coverage.

Pull requests

You SHOULD do the following when preparing your request:

• Rebase your branch before submitting pull request
• Add a descriptive header that explains in a single sentence what problem the PR solves.
• Add a detailed description with animated screen-grab GIFs visualizing how it works.
• Explain why you think it should be implemented one way vs. another, highlight performance improvements, etc.

Thanks! Rocco Howard, H&H|Digital