3. Contributing to PyBluez

This project is not currently under active development.

Contributions are strongly desired to resolve compatibility problems on newer systems, address bugs, and improve platform support for various features. Here are some guidelines to follow.

3.1. Compatibility Issues

Please submit compatiblity issues by opening an issue explaining the problem clearly and providing information necessary to reproduce the issue, including sample code and logs.

If you have long logs, please post them on https://gist.github.com and link to the Gist in your issue.

3.2. Bugs

Please submit bug reports by opening an issue explaining the problem clearly using code examples.

3.3. Coding

Todo

Develop PyBluez coding standards and style guides.

3.4. Documentation

The documentation source lives in the docs folder. Contributions to the documentation are welcome but should be easy to read and understand. All source documents are in restructured text format.

Todo

Develop PyBluez documentation standards and style guides.

3.5. Commit messages and pull requests

Commit messages should be concise but descriptive, and in the form of an instructional patch description (e.g., “Add macOS support” not “Added macOS support”).

Commits which close, or intend to close, an issue should include the phrase “fix #234” or “close #234” where #234 is the issue number, as well a short description, for example: “Add logic to support Win10, fix #234”. Pull requests should aim to match or closely match the corresponding issue title.

3.6. Copyrights

By submitting to this project you agree to your code or documentation being released under the projects license. Copyrights on submissions are owned by their authors. Feel free to append your name to the list of contributors in contributors.rst found in the projects docs folder as part of your pull request!