We want to make contributing to this project as easy and transparent as possible.
We actively welcome your pull requests.
- Fork the repo and create your branch from
master
. - If you've added code, please also add unit tests using the Python
unittest
framework and libraries available in thetesting
directory. - If you've changed APIs, update the documentation and tutorials. Ensure that all changes are backwards compatible and will not change the behavior or storage location of existing models.
- Ensure the test suite passes.
- Make sure your code lints using pylint and flake8.
- If you haven't already, complete the Contributor License Agreement ("CLA").
- Make a pull request for the fork.
In order to accept your pull request, we need you to submit a CLA. You only need to do this once to work on any of Facebook's open source projects.
Complete your CLA here: https://code.facebook.com/cla
We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
Facebook has a bounty program for the safe disclosure of security bugs. In those cases, please go through the process outlined on that page and do not file a public issue.
- 4 spaces for indentation rather than tabs
- 120 character line limit
- Please follow the style in the existing codebase
Our goal is to keep this codebase concise, simple, and easy to extend. We are trying to avoid adding code for specialized purposes that are not generally applicable to future users of this codebase under the goals laid out in the readme. We ask that you propose changes with the spirit of this purpose in mind, and we may request modification or reject changes if we think they will add too much clutter.
This codebase will largely be maintained by Jonathan Frankle. He's a busy PhD student, and he apologizes in advance that his response time will be slow. Please follow the processes outlined in this document for making contributions and noting issues rather than contacting him directly, and please be patient and understanding with him.