Skip to content

Latest commit

 

History

History
31 lines (17 loc) · 1.57 KB

CONTRIBUTING.md

File metadata and controls

31 lines (17 loc) · 1.57 KB

Contributing to Consolidation

Thank you for your interest in contributing to the Consolidation effort! Consolidation aims to provide reusable, loosely-coupled components useful for building command-line tools. Consolidation is built on top of Symfony Console, but aims to separate the tool from the implementation details of Symfony.

Here are some of the guidelines you should follow to make the most of your efforts:

Code Style Guidelines

Consolidation adheres to the PSR-2 Coding Style Guide for PHP code.

Pull Request Guidelines

Every pull request is run through:

It is easy to run the unit tests and code sniffer locally; just run:

  • composer cs

To run the code beautifier, which will fix many of the problems reported by phpcs:

  • composer cbf

These two commands (composer cs and composer cbf) are defined in the scripts section of composer.json.

After submitting a pull request, please examine the Scrutinizer report. It is not required to fix all Scrutinizer issues; you may ignore recommendations that you disagree with. The spacing patches produced by Scrutinizer do not conform to PSR2 standards, and therefore should never be applied. DocBlock patches may be applied at your discression. Things that Scrutinizer identifies as a bug nearly always need to be addressed.

Pull requests must pass phpcs and phpunit in order to be merged; ideally, new functionality will also include new unit tests.