Update README.md with a better documented sample workflow

Signed-off-by: Avi Miller <[email protected]>

Author: Djelibeybi

README.md

@@ -1,32 +1,29 @@
 # Configure `kubectl` for Oracle Container Engine for Kubernetes
 
-Use this GitHub Action to install and configure `kubectl` to connect to
-the specified [Oracle Container Engine for Kubernetes][OKE] (OKE) cluster.
+Use this GitHub Action to install and configure `kubectl` to connect to the specified [Oracle Container Engine for Kubernetes][1] (OKE) cluster.
 
 ## Prerequisites
 
-The target OKE cluster must have a **public Kubernetes API Endpoint** in
-order for the GitHub Action to successfully connect to the cluster.
+The target OKE cluster must have a **public Kubernetes API Endpoint** in order for the GitHub Action to successfully connect to the cluster.
 
-The following [OCI CLI environment variables][1] must be defined for at least
-the `configure-kubectl-oke` task:
+The following [OCI CLI environment variables][2] must be defined for the workflow:
 
 * `OCI_CLI_USER`
 * `OCI_CLI_TENANCY`
 * `OCI_CLI_FINGERPRINT`
 * `OCI_CLI_KEY_CONTENT`
 * `OCI_CLI_REGION`
 
-We recommend using GitHub Secrets to store these values. [Defining your environment variables][2]
-at the job or workflow level would allow multiple tasks/jobs to reduce
-duplication.
+We recommend using GitHub Secrets to store these values. [Defining your environment variables][3] at the job or workflow level would allow multiple tasks/jobs to reduce duplication.
 
 ## Inputs
 
 * `cluster`: (Required) The OCID of the OKE cluster to configure
 
 ## Sample workflow steps
 
+The following sample workflow configures `kubectl` for the `OKE_CLUSTER_OCID` OKE cluster.
+
 ```yaml
 jobs:
   install-kubectl:
@@ -41,56 +38,31 @@ jobs:
 
     steps:
       - name: Configure Kubectl
-        uses: oracle-actions/configure-kubectl-oke@v1
+        uses: oracle-actions/configure-kubectl-oke@v1.0
         id: test-configure-kubectl-oke-action
         with:
-          cluster: ${{ secrets.OKE_CLUSTER }}
+          cluster: ${{ secrets.OKE_CLUSTER_OCID }}
 
       - name: Run Kubectl
         run: kubectl get nodes -A
 ```
 
-## Security recommendations
-
-The **[Oracle Cloud Infrastructure Security Guide][OSG]** details our recommended
-**[best practices for securing user authentication][BP]** which include:
-
-* creating **a dedicated service user account** specifically for GitHub Actions;
-* assigning that service account a **unique** and **complex** password;
-* **rotating the API signing key pair** used by the service account every 90 days; and
-* using **[GitHub encrypted secrets][GHS]** to store credentials.
-
-> **Tip:** if you [create these secrets in your organization][SO], you can limited
-> which repositories have access to these secrets while also avoiding duplicating
-> the credentials in multiple repositories.
-
 ## Contributing
 
-We welcome contributions from the community. Please review our [contribution guide][CG],
-then [start a discussion][SD] or [open an issue][OI] and let us know what you'd
-like to contribute.
+We welcome contributions from the community. Before submitting a pull request, please [review our contribution guide][4].
 
 ## Security
 
-Please consult the [security guide][SG] for our responsible security
-vulnerability disclosure process.
+Please consult the [security guide][5] for our responsible security vulnerability disclosure process.
 
 ## License
 
-Copyright (c) 2021 Oracle and/or its affiliates.
-
-Released under the Universal Permissive License v1.0 as shown at
-<https://oss.oracle.com/licenses/upl/>.
-
-[1]: https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/clienvironmentvariables.htm
-[2]: https://docs.github.com/en/actions/learn-github-actions/environment-variables
-[OKE]: https://www.oracle.com/cloud-native/container-engine-kubernetes/
-[CC]:  http://github.com/oracle-actions/configure-oci-credentials
-[OSG]: https://docs.oracle.com/en-us/iaas/Content/Security/Concepts/security_guide.htm
-[BP]:  https://docs.oracle.com/en-us/iaas/Content/Security/Reference/iam_security.htm
-[GHS]: https://docs.github.com/en/actions/reference/encrypted-secrets
-[SO]:  https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization
-[CG]:  /CONTRIBUTING.md
-[SD]:  https://github.com/oracle-actions/configure-kubectl-oke/discussions
-[OI]:  https://github.com/oracle-actions/configure-kubectl-oke/issues
-[SG]:  ./SECURITY.md
+Copyright (c) 2021, 2022, Oracle and/or its affiliates.
+
+Released under the Universal Permissive License v1.0 as shown at <https://oss.oracle.com/licenses/upl/>.
+
+[1]: https://www.oracle.com/cloud-native/container-engine-kubernetes/
+[2]: https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/clienvironmentvariables.htm
+[3]: https://docs.github.com/en/actions/learn-github-actions/environment-variables
+[4]:  /CONTRIBUTING.md
+[5]:  ./SECURITY.md