Additional information is available at the following locations.
| Topic | Description | Location |
|---|---|---|
| Code of Conduct | How we welcome others to this community. | CODE_OF_CONDUCT.md |
| Development Activities | How we create software in this community. | DEVELOPMENT.md |
| Security | How to report vulnerabilities in our software. | SECURITY.md |
If you experience a problem with our software, please visit issues and create a Bug report.
If you would like to suggest a new feature for our software, please visit issues and create a Feature request.
We use these labels to help us track and manage Bug reports and Feature requests.
| Label | Description |
|---|---|
bug |
Something isn't working. |
enhancement |
New feature or request. |
help wanted |
Extra attention is needed. |
good first issue |
Good for newcomers. |
documentation |
Improvements or additions to documentation. |
For specific proposals, please provide them as pull requests or issues via our GitHub site.
The DEVELOPMENT.md file explains how to install the program locally (highly recommended if you're going to make code changes). It also provides information useful for making changes and validating them locally before submitting a pull request.
Pull requests are preferred, since they are specific. For more about how to create a pull request, see https://help.github.com/articles/using-pull-requests/.
We recommend creating different branches for different (logical) changes, and creating a pull request into the main branch when you're done. See the GitHub documentation on creating branches and using pull requests.
We use GitHub to track proposed changes via its issue tracker and pull requests. Specific changes are proposed using those mechanisms. Issues are assigned to an individual, who works and then marks it complete. If there are questions or objections, the conversation of that issue or pull request is used to resolve it.
In general we try to be proactive to detect and eliminate mistakes and vulnerabilities as soon as possible, and to reduce their impact when they do happen. We use a defensive design and coding style to reduce the likelihood of mistakes, a variety of tools that try to detect mistakes early, and an automatic test suite with significant coverage. We also release the software as open source software so others can review it.
Since early detection and impact reduction can never be perfect, we also try to detect and repair problems during deployment as quickly as possible. This is especially true for security issues; see our security information for more information.
Please privately report vulnerabilities you find so we can fix them!
See SECURITY.md for information on how to privately report vulnerabilities.
This Code of Conduct is adapted from the Contributor Covenant, version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/