Skip to content

Latest commit

 

History

History
41 lines (22 loc) · 3.21 KB

CONTRIBUTING.md

File metadata and controls

41 lines (22 loc) · 3.21 KB

How to Contribute to Concrete5 Core Code

Community contributions are one of the key points that make open source software so great. And concrete5 is no exception, so we'd like to thank you for your help.

What We'd Love Help On

We've tried to categorize our issues in ways that will make it clear how best we can use your help. In general, if something is labelled as "accepted:ready to start" it is ready for development! If you find an issue that is labeled in this way, without a dedicated person assigned to it, post that you'd like to work on it, and go for it. When you're done submit a pull request and we'll review it right away for inclusion.

We have a lot of items we'd like help on: if you find an issue tagged as "accepted:ready to start" and either "priority:like to have" or "priority:love to have" you'll know that this is something we'd really, really like to get. We'd love the assistance.

Helpful Links:

Pull Requests

Before submitting pull requests, please be sure to read these pages:

  • Adopting a common coding style makes developers life easier and may be helpful in finding some kind of bugs. Furthermore, like @aembler once said, we have to be good citizens: speaking the same dialect is useful for everybody. So, please be sure to consult the Coding-Style Guidelines.

    One easy, secure and fast way to fix coding style problems is using php-cs-fixer. To fix a file simply call

    php-cs-fixer --config-file==<webroot>/.php_cs fix <filename>

    Please run the above command on every PHP-only file included in your pull requests (preferably in a separated commit).

  • Pull requests that address existing issues are much much more likely to be accepted than unsolicited pull requests.

  • Pull requests should normally be directed at the develop branch. Master is reserved for the most recent stable release. Read more about the gitflow branching model.

  • If you used to develop for concrete5 Legacy (v5.6 and older), you should read the Migration Guide: it explains some of the main differences introduced in concrete5 5.7 and later.

Github issues vs Bug tracker

Github is not the place for unconfirmed bugs. If this is an unconfirmed bug (and almost all of them are), they should be posted to the official concrete5 bug tracker so that they can be confirmed and voted on. Just because something is posted here does not guarantee it will be placed into a release milestone. Exceptions to this rule include issues that are accompanied by a pull request, but even a pull request isn't guaranteed to be accepted into the core.

Thanks everyone!