woocommerce/CONTRIBUTING.md

40 lines
2.4 KiB
Markdown
Raw Normal View History

2012-11-06 12:22:42 +00:00
# How to contribute
2012-11-29 03:06:05 +00:00
Community made patches, localisations, bug reports and contributions are always welcome and are crucial to ensure WooCommerce remains the #1 eCommerce platform for WordPress ;)
2012-11-06 12:22:42 +00:00
When contributing please ensure you follow the guidelines below so that we can keep on top of things.
__Note:__
2013-05-30 09:24:16 +00:00
GitHub is for *bug reports and contributions only* - if you have a support question or a request for a customization don't post here. Use [WooThemes Support](http://support.woothemes.com) for customer support, [WordPress.org](http://wordpress.org/support/plugin/woocommerce) for community support, and for customisations we recommend one of the following services:
2013-05-30 09:24:16 +00:00
- [Codeable](https://codeable.io/)
- [Affiliated Woo Workers](http://www.woothemes.com/affiliated-woo-workers/)
2012-11-06 12:22:42 +00:00
## Getting Started
* Make sure you have a [GitHub account](https://github.com/signup/free)
* Submit a ticket for your issue, assuming one does not already exist.
* Clearly describe the issue including steps to reproduce when it is a bug.
* Make sure you fill in the earliest version that you know has the issue.
2013-03-01 16:10:03 +00:00
## Making Changes
2012-11-06 12:22:42 +00:00
* Fork the repository on GitHub.
* Make the changes to your forked repository.
* **Ensure you stick to the [WordPress Coding Standards](http://make.wordpress.org/core/handbook/coding-standards/php/).**
* Ensure you use LF line endings - no crazy windows line endings. :)
* When committing, reference your issue (#1234) and include a note about the fix.
* Push the changes to your fork and submit a pull request on the master branch of the WooCommerce repository. Existing maintenance branches will be maintained of by WooCommerce developers.
* Please **don't** modify the changelog - this will be maintained by the WooCommerce developers.
2015-07-15 00:50:35 +00:00
* Please **don't** add your localizations or update the .pot files - this will be maintained by the WooCommerce developers. To contribute to the localization of WooCommerce, please join the [WooCommerce Transifex project](https://www.transifex.com/projects/p/woocommerce/).
2012-11-06 12:22:42 +00:00
2013-03-01 16:10:03 +00:00
At this point you're waiting on us to merge your pull request. We'll review all pull requests, and make suggestions and changes if necessary.
2012-11-06 12:22:42 +00:00
# Additional Resources
* [General GitHub documentation](http://help.github.com/)
* [GitHub pull request documentation](http://help.github.com/send-pull-requests/)
2013-03-01 16:10:03 +00:00
* [WooCommerce Docs](http://docs.woothemes.com/)
* [WooThemes Support](http://support.woothemes.com)