How to contribute

Everybody should be able to help. Here's how you can make this project more awesome:

  1. Fork it
  2. improve it
  3. submit a pull request

Your work will then be reviewed as soon as possible (suggestions about some changes, improvements or alternatives may be given).

Here's some tips to make you the best contributor ever:

Getting started

First, set up your local environment:

make lib-init

Note: Run make or make help to see all available commands.

Standard code

Use PHP CS fixer to make your code compliant with Memio's coding standards:

make cs-fix

Tests

Memio uses PHPUnit for testing.

Run the tests:

make phpunit

Results should be green!

Full QA check

Before submitting your pull request, run the full QA pipeline:

make lib-qa

Keeping your fork up-to-date

To keep your fork up-to-date, you should track the upstream (original) one using the following command:

$ git remote add upstream https://github.com/memio/memio.git

Then get the upstream changes:

git checkout main
git pull --rebase origin main
git pull --rebase upstream main
git checkout <your-branch>
git rebase main

Finally, publish your changes:

$ git push -f origin <your-branch>

Your pull request will be automatically updated.