Wenzel Jakob | 71c5d80 | 2016-04-14 21:42:51 +0200 | [diff] [blame] | 1 | Thank you for your interest in this project! Please refer to the following |
| 2 | sections on how to contribute code and bug reports. |
| 3 | |
| 4 | ### Reporting bugs |
| 5 | |
| 6 | At the moment, this project is run in the spare time of a single person |
| 7 | ([Wenzel Jakob](http://rgl.epfl.ch/people/wjakob)) with very limited resources |
| 8 | for issue tracker tickets. Thus, before submitting a question or bug report, |
| 9 | please take a moment of your time and ensure that your issue isn't already |
| 10 | discussed in the project documentation provided at |
| 11 | [http://pybind11.readthedocs.org/en/latest](http://pybind11.readthedocs.org/en/latest). |
| 12 | |
| 13 | Assuming that you have identified a previously unknown problem or an important |
| 14 | question, it's essential that you submit a self-contained and minimal piece of |
| 15 | code that reproduces the problem. In other words: no external dependencies, |
| 16 | isolate the function(s) that cause breakage, submit matched and complete C++ |
| 17 | and Python snippets that can be easily compiled and run on my end. |
| 18 | |
| 19 | ## Pull requests |
| 20 | Contributions are submitted, reviewed, and accepted using Github pull requests. |
| 21 | Please refer to [this |
| 22 | article](https://help.github.com/articles/using-pull-requests) for details and |
| 23 | adhere to the following rules to make the process as smooth as possible: |
| 24 | |
| 25 | * Make a new branch for every feature you're working on. |
| 26 | * Make small and clean pull requests that are easy to review but make sure they |
| 27 | do add value by themselves. |
Jason Rhinelander | 79583b5 | 2016-08-28 14:26:50 -0400 | [diff] [blame] | 28 | * Add tests for any new functionality and run the test suite (``make pytest``) |
| 29 | to ensure that no existing features break. |
Wenzel Jakob | 71c5d80 | 2016-04-14 21:42:51 +0200 | [diff] [blame] | 30 | * This project has a strong focus on providing general solutions using a |
| 31 | minimal amount of code, thus small pull requests are greatly preferred. |
| 32 | |
| 33 | ### License |
| 34 | |
| 35 | pybind11 is provided under a BSD-style license that can be found in the |
| 36 | ``LICENSE`` file. By using, distributing, or contributing to this project, you |
| 37 | agree to the terms and conditions of this license. |