First of all, thank you for contributing!
Here are a few rules to follow in order to ease code reviews and merging:
- follow PSR-1 and PSR-2
- run the test suite
- write (or update) unit tests when applicable
- write documentation for new features
- use commit messages that make sense
One may ask you to squash your commits too. This is used to "clean" your pull request before merging it (we don't want commits such as
fix 3, etc.).
When creating your pull request on GitHub, please write a description which gives the context and/or explains why you are creating it.
To be able to preview Couscous own website on your machine, you will need the following tools installed:
$ npm install -g bower
$ npm install -g less less-plugin-clean-css
Phar generation enabled in
phar.readonly = Off
Then you can run
Building the phar
To generate the phar yourself, you need to allow Phar generation in your
phar.readonly = Off).
You also need to be able to use the
sha1sum cli tool.
The procedure is then quite simple, check out the repository and:
$ composer update $ bin/compile
The phar is generated as
Releasing a new version
Instructions for maintainers:
$ composer update $ bin/compile $ cp bin/couscous.* website/ $ bin/couscous deploy