|
1 | | -# Contributing |
| 1 | +# Contributing to this repository |
2 | 2 |
|
3 | | -Oracle welcomes contributions to this repository from anyone. |
| 3 | +We welcome your contributions! There are multiple ways to contribute. |
4 | 4 |
|
5 | | -If you want to submit a pull request to fix a bug or enhance an existing |
6 | | -feature, please first open an issue and link to that issue when you |
7 | | -submit your pull request. |
| 5 | +## Opening issues |
8 | 6 |
|
9 | | -If you have any questions about a possible submission, feel free to open |
10 | | -an issue too. |
| 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). |
11 | 12 |
|
12 | | -## Contributing to the WebLogic Logging Exporter repository |
| 13 | +## Contributing code |
13 | 14 |
|
14 | | -Pull requests can be made under |
15 | | -[The Oracle Contributor Agreement](https://www.oracle.com/technetwork/community/oca-486395.html) (OCA). |
| 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: |
16 | 19 |
|
17 | | -For pull requests to be accepted, the bottom of your commit message must have |
18 | | -the following line using your name and e-mail address as it appears in the |
19 | | -OCA Signatories list. |
20 | | - |
21 | | -``` |
| 20 | +```text |
22 | 21 | Signed-off-by: Your Name <you@example.org> |
23 | 22 | ``` |
24 | 23 |
|
25 | | -This can be automatically added to pull requests by committing with: |
| 24 | +This can be automatically added to pull requests by committing with `--sign-off` |
| 25 | +or `-s`, e.g. |
26 | 26 |
|
27 | | -``` |
28 | | - git commit --signoff |
| 27 | +```text |
| 28 | +git commit --signoff |
29 | 29 | ``` |
30 | 30 |
|
31 | | -Only pull requests from committers that can be verified as having |
32 | | -signed the OCA can be accepted. |
| 31 | +Only pull requests from committers that can be verified as having signed the OCA |
| 32 | +can be accepted. |
33 | 33 |
|
34 | | -### Pull request process |
| 34 | +## Pull request process |
35 | 35 |
|
| 36 | +1. Ensure there is an issue created to track and discuss the fix or enhancement |
| 37 | + you intend to submit. |
36 | 38 | 1. Fork this repository |
37 | 39 | 1. Create a branch in your fork to implement the changes. We recommend using |
38 | | -the issue number as part of your branch name, e.g. `1234-fixes` |
| 40 | + the issue number as part of your branch name, e.g. `1234-fixes` |
39 | 41 | 1. Ensure that any documentation is updated with the changes that are required |
40 | | -by your fix. |
| 42 | + by your change. |
41 | 43 | 1. Ensure that any samples are updated if the base image has been changed. |
42 | 44 | 1. Submit the pull request. *Do not leave the pull request blank*. Explain exactly |
43 | | -what your changes are meant to do and provide simple steps on how to validate |
44 | | -your changes. Ensure that you reference the issue you created as well. |
45 | | -We will assign the pull request to 2-3 people for review before it is merged. |
| 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