Update README.md

README.md

@@ -126,8 +126,8 @@ Oracle strongly recommends that you ensure your system meets the following [Prer
   ```sh
     kubectl apply -f rbac/node-rbac.yaml
   ```
-# Installation
-## Install Oracle DB Operator
+## Installation
+### Install Oracle DB Operator
 
    After you have completed the preceding prerequisite changes, you can install the operator. To install the operator in the cluster quickly, you can apply the modified `oracle-database-operator.yaml` file from the preceding step.
 
@@ -154,7 +154,7 @@ Oracle strongly recommends that you ensure your system meets the following [Prer
 You should see that the operator is up and running, along with the shipped controllers.
 
 For more details, see [Oracle Database Operator Installation Instructions](./docs/installation/OPERATOR_INSTALLATION_README.md).
-
+## Documentation
 ## Getting Started with the Operator (Quickstart)
 
 The following quickstarts are designed for specific database configurations:
@@ -170,6 +170,7 @@ The following quickstarts are designed for specific database configurations:
 The following quickstart is designed for non-database configurations:
 * [Oracle Database Observability](./docs/observability/README.md)
 
+## Examples
 YAML file templates are available under [`/config/samples`](./config/samples/). You can copy and edit these template files to configure them for your use cases.
 
 ## Uninstall the Operator
@@ -221,15 +222,15 @@ YAML file templates are available under [`/config/samples`](./config/samples/).
 
 ## Contributing
 
-See [Contributing to this Repository](./CONTRIBUTING.md)
+This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)
 
-## Support
+## Help
 
 You can submit a GitHub issue, oir submit an issue and then file an [Oracle Support service](https://support.oracle.com/portal/) request. To file an issue or a service request, use the following product ID: 14430.
 
 ## Security
 
-Secure platforms are an important basis for general system security. Ensure that your deployment is in compliance with common security practices.
+Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process
 
 ### Managing Sensitive Data
 
@@ -244,10 +245,6 @@ The following is an example of a YAML file fragment for specifying Oracle Cloud
 
 Examples in this repository where passwords are entered on the command line are for demonstration purposes only. 
 
-### Reporting a Security Issue
-
-See [Reporting security vulnerabilities](./SECURITY.md)
-
 ## License
 
 Copyright (c) 2022, 2024 Oracle and/or its affiliates.

SECURITY.md

@@ -1,4 +1,4 @@
-# Oracle's instructions for reporting security vulnerabilities
+# Reporting security vulnerabilities
 
 Oracle values the independent security research community and believes that
 responsible disclosure of security vulnerabilities helps us ensure the security
@@ -21,7 +21,7 @@ security features are welcome on GitHub Issues.
 
 Security updates will be released on a regular cadence. Many of our projects
 will typically release security fixes in conjunction with the
-[Oracle Critical Patch Update][3] program. Additional
+Oracle Critical Patch Update program. Additional
 information, including past advisories, is available on our [security alerts][4]
 page.
 
@@ -35,4 +35,4 @@ sufficiently hardened for production use.
 [1]: mailto:secalert_us@oracle.com
 [2]: https://www.oracle.com/corporate/security-practices/assurance/vulnerability/reporting.html
 [3]: https://www.oracle.com/security-alerts/encryptionkey.html
-[4]: https://www.oracle.com/security-alerts/
+[4]: https://www.oracle.com/security-alerts/