Contributions to the Magento 2 codebase are done using the fork & pull model. This contribution model has contributors maintaining their own fork of the Magento 2 repository. The forked repository is then used to submit a request to the base repository to “pull” a set of changes. For more information on pull requests please refer to GitHub Help.
Contributions can take the form of new components or features, changes to existing features, tests, documentation (such as developer guides, user guides, examples, or specifications), bug fixes or optimizations.
The Magento 2 development team or community maintainers will review all issues and contributions submitted by the community of developers in the first in, first out order. During the review we might require clarifications from the contributor. If there is no response from the contributor within two weeks, the pull request will be closed.
For more detailed information on contribution please read our beginners guide.
- Pull requests (PRs) must be accompanied by a meaningful description of their purpose. Comprehensive descriptions increase the chances of a pull request being merged quickly and without additional clarification requests.
- Commits must be accompanied by meaningful commit messages. Please see the Magento Pull Request Template for more information.
- PRs which include new logic or new features must be submitted along with:
- Scenarios that describe how new functionality will be used by clients
- Proposed documentation updates. Documentation contributions can be submitted via the devdocs GitHub.
- Sign Magento's CLA, which is here
If you are a new GitHub user, we recommend that you create your own free github account. This will allow you to collaborate with the Magento 2 development team, fork the Magento 2 project and send pull requests.
- Review the Contributor License Agreement if this is your first time contributing.
- Fork the catalog-storefront-ce repository and when you are ready to send us a pull request – follow the Create A Pull Request instructions.
- Once your contribution is received the Magento 2 development team will review the contribution and collaborate with you as needed.
Please note that this project is released with a Contributor Code of Conduct. We expect you to agree to its terms when participating in this project. The full text is available in the repository Wiki.
If you have any questions, join us in #beginners Slack chat. If you are not on our slack, click here to join.
Need to find a project? Check out the Slack Channels (with listed project info) and the Magento Community Portal.