mirror of
https://github.com/python-pillow/Pillow.git
synced 2025-01-13 18:56:17 +03:00
31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# Contributing to Pillow
|
|
|
|
Contributions of bug fixes, feature additions, tests, documentation and more can be made via [issues](https://github.com/python-pillow/Pillow/issues) and/or [pull requests](https://github.com/python-pillow/Pillow/issues).
|
|
|
|
## Bug fixes, feature additions, etc.
|
|
|
|
Please send a pull request to the master branch. Please include documentation and [tests](Tests/README.rst) for new features. Tests or documentation on their own are also welcomed. Feel free to ask questions as an [issue](https://github.com/python-pillow/Pillow/issues/new) or on IRC (irc.freenode.net, #pil)
|
|
|
|
- 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
|
|
|
|
- Try to keep any code commits clean and separate from reformatting commits.
|
|
- Provide tests for any newly added code.
|
|
- Follow PEP8.
|
|
|
|
## Reporting Issues
|
|
|
|
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.
|
|
|
|
### Provide details
|
|
|
|
- What did you do?
|
|
- What did you expect to happen?
|
|
- What actually happened?
|
|
- What versions of Pillow and Python are you using?
|