|
1 |
| ---- |
2 |
| - |
3 |
| ---- |
4 |
| - |
5 |
| -# Source Code Submissions |
6 |
| -We welcome your contributions and look forward to collaborating with you. We can only accept source code repository |
7 |
| -submissions from users who have signed and returned the Oracle |
8 |
| -Contributor Agreement. You will find details and the agreement to sign at this OTN web page: |
9 |
| -[Oracle Contributor Agreement](http://www.oracle.com/technetwork/community/oca-486395.html). |
10 |
| - |
11 |
| -# Other Contributions |
12 |
| -For all project Submissions other than source code repository contributions, the following also applies: Oracle does |
13 |
| -not claim ownership of Your Submissions. However, in order to fulfill |
14 |
| -the purposes of this project, You must give Oracle and all Users |
15 |
| -the right to post, access, discuss, use, publish, disseminate, and refine |
16 |
| -Your Submissions. |
17 |
| - |
18 |
| -In legalese: *You hereby grant to Oracle and all |
19 |
| -Users a royalty-free, perpetual, irrevocable, worldwide, non-exclusive, |
20 |
| -and fully sub-licensable right and license, under Your intellectual |
21 |
| -property rights, to reproduce, modify, adapt, publish, translate, create |
22 |
| -derivative works from, distribute, perform, display, and use Your |
23 |
| -Submissions (in whole or part) and to incorporate or implement them in |
24 |
| -other works in any form, media, or technology now known or later |
25 |
| -developed, all subject to the obligation to retain any copyright notices |
26 |
| -included in Your Submissions. All Users, Oracle, and their |
27 |
| -sublicensees are responsible for any modifications they make to the |
28 |
| -Submissions of others.* |
29 |
| - |
30 |
| -Copyright 2017, 2019, Oracle and/or its affiliates. |
31 |
| -Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl. |
| 1 | +# Contributing to this repository |
| 2 | + |
| 3 | +We welcome your contributions! There are multiple ways to contribute. |
| 4 | + |
| 5 | +## Opening issues |
| 6 | + |
| 7 | +For bugs or enhancement requests, please file a GitHub issue unless it's |
| 8 | +security related. When filing a bug remember that the better written the bug is, |
| 9 | +the more likely it is to be fixed. If you think you've found a security |
| 10 | +vulnerability, do not raise a GitHub issue and follow the instructions in our |
| 11 | +[security policy](./SECURITY.md). |
| 12 | + |
| 13 | +## Contributing code |
| 14 | + |
| 15 | +We welcome your code contributions. Before submitting code via a pull request, |
| 16 | +you will need to have signed the [Oracle Contributor Agreement][OCA] (OCA) and |
| 17 | +your commits need to include the following line using the name and e-mail |
| 18 | +address you used to sign the OCA: |
| 19 | + |
| 20 | +```text |
| 21 | +Signed-off-by: Your Name <[email protected]> |
| 22 | +``` |
| 23 | + |
| 24 | +This can be automatically added to pull requests by committing with `--sign-off` |
| 25 | +or `-s`, e.g. |
| 26 | + |
| 27 | +```text |
| 28 | +git commit --signoff |
| 29 | +``` |
| 30 | + |
| 31 | +Only pull requests from committers that can be verified as having signed the OCA |
| 32 | +can be accepted. |
| 33 | + |
| 34 | +## Pull request process |
| 35 | + |
| 36 | +1. Ensure there is an issue created to track and discuss the fix or enhancement |
| 37 | + you intend to submit. |
| 38 | +1. Fork this repository |
| 39 | +1. Create a branch in your fork to implement the changes. We recommend using |
| 40 | + the issue number as part of your branch name, e.g. `1234-fixes` |
| 41 | +1. Ensure that any documentation is updated with the changes that are required |
| 42 | + by your change. |
| 43 | +1. Ensure that any samples are updated if the base image has been changed. |
| 44 | +1. Submit the pull request. *Do not leave the pull request blank*. Explain exactly |
| 45 | + what your changes are meant to do and provide simple steps on how to validate |
| 46 | + your changes. Ensure that you reference the issue you created as well. |
| 47 | +1. We will assign the pull request to 2-3 people for review before it is merged. |
| 48 | + |
| 49 | +## Code of conduct |
| 50 | + |
| 51 | +Follow the [Golden Rule](https://en.wikipedia.org/wiki/Golden_Rule). If you'd |
| 52 | +like more specific guidelines, see the [Contributor Covenant Code of Conduct][COC]. |
| 53 | + |
| 54 | +[OCA]: https://oca.opensource.oracle.com |
| 55 | +[COC]: https://www.contributor-covenant.org/version/1/4/code-of-conduct/ |
0 commit comments