# Contributing

We welcome your code contributions. Before submitting code via a GitHub pull request or by filing a bug in [bugs.mysql.com](https://bugs.mysql.com), you will need to have signed the Oracle Contributor Agreement. Consult the [OCA Page](https://oca.opensource.oracle.com) for additional information.

**Only pull requests from committers that can be verified as having signed the OCA can be accepted.**

## Submitting Code Contributions

1. Make sure you have a user account at [bugs.mysql.com](https://bugs.mysql.com). You'll need to reference this user account when you submit your OCA (Oracle Contributor Agreement).
2. Sign the Oracle OCA. You can find instructions for doing that at the [OCA Page](https://oca.opensource.oracle.com).
3. Validate your contribution by including tests that sufficiently cover the functionality.
4. Verify that the entire test suite passes with your code applied.
5. Submit your pull request via [GitHub](https://github.com/mysql/mysql-connector-cpp/pulls/) or uploading it to a bug record in [bugs.mysql.com](https://bugs.mysql.com) using the _Contributions_ tab.

## None-Code Contributions

Submissions Other than Code. These terms apply to all of Your Submissions other than code contributions.

"You" means you personally, as well as any person or entity on whose behalf you are Using the Site. "You" does not include Oracle or its employees using the Site on Oracle's behalf. "Use" and its variants are to be interpreted in their broadest sense and include, without limitation, the acts of using, accessing, receiving, browsing, downloading from, and uploading to. A "User" is a person or entity who Uses the site. "Submissions" means any materials (other than code contributions), including but not limited to technology specifications, technical materials, documentation, discussion thread postings, blogs, wikis, data, and any other content, information, technology or services submitted to by You to the site.

You hereby grant to Oracle and all Users a royalty-free, perpetual, irrevocable, worldwide, non-exclusive and fully sub-licensable right and license under Your intellectual property rights to reproduce, modify, adapt, publish, translate, create derivative works from, distribute, perform, display and use Your Submissions (in whole or part) and to incorporate or implement them in other works in any form, media, or technology now known or later developed. This includes, without limitation, the right to incorporate or implement the Submission into any product or service, and to display, market, sublicense and distribute the Submissions as incorporated or embedded in any product or service distributed or offered by Oracle without compensation to you.

All Users, Oracle, and their sublicensees are responsible for any modifications they make to the Submissions of others.

## Contributing Guidelines

We love getting feedback from our users. Bugs and code contributions are great forms of feedback and we thank you for any bugs you report or code you contribute.

### Reporting Issues

Before reporting a new bug, please check first to see if a similar bug [exists](https://bugs.mysql.com/search.php).

Bug reports should be as complete as possible.  Please try and include the following:

* complete steps to reproduce the issue
* any information about platform and environment that could be specific to
  the bug
* Specific version of the product you are using
* Specific version of the server being used
* C++ code to help reproduce the issue if possible

Please do NOT raise a GitHub Issue to report a security vulnerability.
See SECURITY.md for additional information.
