woocommerce/.github/CONTRIBUTING.md

56 lines
5.2 KiB
Markdown
Raw Normal View History

2018-05-09 10:40:21 +00:00
# Contributing to WooCommerce ✨
2012-11-06 12:22:42 +00:00
WooCommerce powers many online stores across the internet, and your help making it even more awesome will be greatly appreciated :)
2019-07-26 19:05:52 +00:00
There are many ways to contribute to the project!
2012-11-06 12:22:42 +00:00
2019-07-26 19:05:52 +00:00
- [Translating strings into your language](https://github.com/woocommerce/woocommerce/wiki/Translating-WooCommerce).
- Answering questions on the various WooCommerce communities like the [WP.org support forums](https://wordpress.org/support/plugin/woocommerce/).
- Testing open [issues](https://github.com/woocommerce/woocommerce/issues) or [pull requests](https://github.com/woocommerce/woocommerce/pulls) and sharing your findings in a comment.
- Testing WooCommerce beta versions and release candidates. Those are announced in the [WooCommerce development blog](https://woocommerce.wordpress.com/).
2018-05-09 10:40:21 +00:00
- Submitting fixes, improvements, and enhancements.
2019-07-26 19:05:52 +00:00
- To disclose a security issue to our team, [please submit a report via HackerOne](https://hackerone.com/automattic/).
2012-11-06 12:22:42 +00:00
If you wish to contribute code, please read the information in the sections below. Then [fork](https://help.github.com/articles/fork-a-repo/) WooCommerce, commit your changes, and [submit a pull request](https://help.github.com/articles/using-pull-requests/) 🎉
2013-05-30 09:24:16 +00:00
We use the `good first issue` label to mark issues that are suitable for new contributors. You can find all the issues with this label [here](https://github.com/woocommerce/woocommerce/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22).
2019-07-31 12:05:12 +00:00
WooCommerce is licensed under the GPLv3+, and all contributions to the project will be released under the same license. You maintain copyright over any contribution you make, and by submitting a pull request, you are agreeing to release that contribution under the GPLv3+ license.
2013-05-30 09:24:16 +00:00
2019-07-26 19:05:52 +00:00
If you have questions about the process to contribute code or want to discuss details of your contribution, you can contact WooCommerce core developers on the #core channel in the [WooCommerce community Slack](https://woocommerce.com/community-slack/).
2018-05-09 10:40:21 +00:00
2019-07-26 19:05:52 +00:00
## Getting started
2018-05-09 10:40:21 +00:00
- [How to set up WooCommerce development environment](https://github.com/woocommerce/woocommerce/wiki/How-to-set-up-WooCommerce-development-environment)
- [Git Flow](https://github.com/woocommerce/woocommerce/wiki/WooCommerce-Git-Flow)
- [Minification of SCSS and JS](https://github.com/woocommerce/woocommerce/wiki/Minification-of-SCSS-and-JS)
- [Naming conventions](https://github.com/woocommerce/woocommerce/wiki/Naming-conventions)
- [String localisation guidelines](https://github.com/woocommerce/woocommerce/wiki/String-localisation-guidelines)
2019-07-26 19:05:52 +00:00
- [Running unit tests](https://github.com/woocommerce/woocommerce/blob/master/tests/README.md)
- [Running e2e tests](https://github.com/woocommerce/woocommerce/wiki/End-to-end-Testing)
2015-08-03 14:48:07 +00:00
2019-07-10 11:57:02 +00:00
## Coding Guidelines and Development 🛠
2015-08-03 14:48:07 +00:00
2019-07-26 19:05:52 +00:00
- Ensure you stick to the [WordPress Coding Standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/php/)
- Run our build process described in the document on [how to set up WooCommerce development environment](https://github.com/woocommerce/woocommerce/wiki/How-to-set-up-WooCommerce-development-environment), it will install our pre-commit hook, code sniffs, dependencies, and more.
2019-07-26 19:05:52 +00:00
- Whenever possible please fix pre-existing code standards errors in the files that you change. It is ok to skip that for larger files or complex fixes.
2018-05-09 10:40:21 +00:00
- Ensure you use LF line endings in your code editor. Use [EditorConfig](http://editorconfig.org/) if your editor supports it so that indentation, line endings and other settings are auto configured.
- When committing, reference your issue number (#1234) and include a note about the fix.
2019-06-26 16:20:47 +00:00
- Ensure that your code supports the minimum supported versions of PHP and WordPress; this is shown at the top of the `readme.txt` file.
- Push the changes to your fork and submit a pull request on the master branch of the WooCommerce repository.
2019-07-26 19:05:52 +00:00
- Make sure to write good and detailed commit messages (see [this post](https://chris.beams.io/posts/git-commit/) for more on this) and follow all the applicable sections of the pull request template.
- Please avoid modifying the changelog directly or updating the .pot files. These will be updated by the WooCommerce team.
2012-11-06 12:22:42 +00:00
If you are contributing code to the (Javascript-driven) WooCommerce Admin project or to Gutenberg blocks, note that these are developed in external packages.
2021-02-16 20:43:18 +00:00
- [WooCommerce Admin](https://github.com/woocommerce/woocommerce-admin)
2019-07-10 11:57:02 +00:00
- [Blocks](https://github.com/woocommerce/woocommerce-gutenberg-products-block)
2019-07-26 19:05:52 +00:00
## Feature Requests 🚀
Feature requests can be [submitted to our issue tracker](https://github.com/woocommerce/woocommerce/issues/new?template=6-Feature-request.md). Be sure to include a description of the expected behavior and use case, and before submitting a request, please search for similar ones in the closed issues.
2019-07-26 19:05:52 +00:00
Feature request issues will remain closed until we see sufficient interest via comments and [👍 reactions](https://help.github.com/articles/about-discussions-in-issues-and-pull-requests/) from the community.
You can see a [list of current feature requests which require votes here](https://github.com/woocommerce/woocommerce/issues?q=is%3Aclosed+label%3A%22type%3A+enhancement%22+label%3A%22votes+needed%22+sort%3Areactions-%2B1-desc).