29
0
mirror of https://github.com/joomla/joomla-cms.git synced 2024-07-05 11:33:39 +00:00
cms/.github/CONTRIBUTING.md
2022-09-06 08:08:56 +01:00

2.3 KiB

Contributing to the Joomla! CMS™

You are welcome to submit a contribution for review and possible inclusion in the Joomla! CMS but, before it will be accepted, we ask that you follow these simple steps:

  1. Open an issue on our Issue Tracker or here on GitHub. If you can, please provide a fix and create a pull request (PR) instead; this will automatically create an issue for you so you do not have to create an issue if you are creating a pull request.

  2. Follow the Joomla! Coding Standards.

  3. When filing an issue or opening a PR, please include a clear title and description. The title should be a short summary of an issue and, if possible, should include a reference to an open issue. For example, Invalid Query in com_admin (Ref #1234) would be sufficient. All issues and PRs should include a description with as much detail as possible. If it is a PR, include what the issue is, what the PR is addressing, testing instructions and environmental information (PHP version, database driver and version, and other data you can retrieve from your site's system information view) in case the issue is specific to certain environments. If additional information is needed, please be prepared to provide it as our community members review your submission.

  4. Report security issues to the Joomla! Security Strike Team (JSST) at security@joomla.org or use the JSST contact form. Please do not use the public tracker for security issues.

Please be patient as not all items will be tested immediately (remember, all bug testing for the Joomla! CMS is done by volunteers) and be receptive to feedback about your code.

Branches

PRs should usually be made to the 4.2-dev branch as this contains the most recent version of the code. There are other branches available which serve specific purposes.

Branch Purpose
3.10-dev Branch for the Joomla 3.x series. The 3.10 series release will now only include security patches.
4.2-dev Branch for the current minor Joomla version.
4.3-dev Branch for the next minor Joomla version. New features go into this branch. Commits to 4.2-dev will be applied to this branch as well.
5.0-dev Branch for the next major Joomla version.