CONTRIBUTING.md

CONTRIBUTING

We are using GitHub Actions as a continuous integration system.

For details, take a look at the following workflow configuration files:

• workflows/close.yaml
• workflows/integrate.yaml
• workflows/triage.yaml

Coding Standards

We are using ergebnis/composer-normalize to normalize composer.json.

We are using yamllint to enforce coding standards in YAML files.

If you do not have yamllint installed yet, run

$ brew install yamllint

to install yamllint.

We are using friendsofphp/php-cs-fixer to enforce coding standards in PHP files.

Run

$ make coding-standards

to automatically fix coding standard violations.

Static Code Analysis

We are using phpstan/phpstan to statically analyze the code.

Run

$ make static-code-analysis

to run a static code analysis.

We are also using the baseline feature of phpstan/phpstan.

Run

$ make static-code-analysis-baseline

to regenerate the baselines in

• ../phpstan-with-extension-baseline.neon
• ../phpstan-without-extension-baseline.neon

❗ Ideally, the baselines should shrink over time.

Tests

We are using phpunit/phpunit to drive the development.

Run

$ make tests

to run all the tests.

Extra lazy?

Run

$ make

to enforce coding standards, run a static code analysis, and run tests!

Help

💡 Run

$ make help

to display a list of available targets with corresponding descriptions.