Pillow/CONTRIBUTING.md

31 lines
1.7 KiB
Markdown
Raw Normal View History

2015-04-05 03:36:53 +03:00
# Contributing to Pillow
2015-04-05 03:57:53 +03:00
Bug fixes, feature additions, tests, documentation and more can be contributed via [issues](https://github.com/python-pillow/Pillow/issues) and/or [pull requests](https://github.com/python-pillow/Pillow/issues). All contributions are welcome.
2014-07-27 14:14:28 +04:00
2015-04-05 03:45:47 +03:00
## Bug fixes, feature additions, etc.
2014-08-04 09:05:32 +04:00
2015-04-05 04:03:40 +03:00
Please send a pull request to the master branch. Please include [documentation](http://pillow.readthedocs.org) and [tests](Tests/README.rst) for new features. Tests or documentation without bug fixes or feature additions are welcome too. Feel free to ask questions [via issues](https://github.com/python-pillow/Pillow/issues/new) or irc://irc.freenode.net#pil
2014-08-04 09:05:32 +04:00
2015-04-05 03:45:47 +03:00
- Fork the Pillow repository.
- Create a branch from master.
- Develop bug fixes, features, tests, etc.
- Run the test suite on both Python 2.x and 3.x. You can enable [Travis CI on your repo](https://travis-ci.org/profile/) to catch test failures prior to the pull request, and [Coveralls](https://coveralls.io/repos/new) to see if the changed code is covered by tests.
- Create a pull request to pull the changes from your branch to the Pillow master.
### Guidelines
2014-07-27 14:14:28 +04:00
2014-08-04 09:05:32 +04:00
- Try to keep any code commits clean and separate from reformatting commits.
2015-04-05 03:45:47 +03:00
- Provide tests for any newly added code.
- Follow PEP8.
## Reporting Issues
2014-07-27 14:14:28 +04:00
2015-04-05 03:45:47 +03:00
When reporting issues, please include example code that reproduces the issue, and if possible a problem image. The best reproductions are self-contained scripts that pull in as few dependencies as possible. An entire Django stack is harder to reproduce.
2014-08-04 09:05:32 +04:00
2015-04-05 03:45:47 +03:00
### Provide details
2014-08-04 09:05:32 +04:00
- What did you do?
- What did you expect to happen?
- What actually happened?
- What versions of Pillow and Python are you using?