Additional update to the Readme

Author: klustria

hols/oci-basic-setup/README.md

@@ -3,33 +3,33 @@
 This example demonstrates how to create a basic OCI infrastructure setup that can be used to deploy a Helidon MP OCI application.
 
 ## Objective
-1. Use Terraform to create automation of OCI resources provisioning that can build a basic OCI infrastructure setup composed of the following:
+1. Use Terraform to automate the provisioning of OCI resources that can build a basic OCI setup composed of the following:
    1. OCI Compute instance with firewall opened at port 8080.
-   2. OCI Virtual Cloud Network with Security List containing an Ingress at port 8080.
+   2. OCI Virtual Cloud Network with a Security List containing an Ingress at port 8080.
    3. Policies to allow OCI Logging and Monitoring services to be accessed from the provisioned OCI Compute instance.
 2. Generate a Helidon MP OCI project using Helidon cli. 
-3. Use OCI cloud-shell to run this example through. 
+3. Use OCI Cloud Shell to run this example through. 
 
 ## Prerequisite
-- An OCI tenancy that has enough capacity to provision an OCI Compute instance and a Virtual Cloud Network. This will also work on the free trial of the [OCI Free Tier](https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetier.htm).
+- An OCI tenancy that has enough capacity to provision an OCI Compute Instance and a Virtual Cloud Network (VCN). This will also work on the free trial of the [OCI Free Tier](https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetier.htm).
 
 ## Tasks
 ### Set up Cloud Shell access.
 1. If you are already a super-user with administrator rights that has access to all resources in the tenancy, skip to the next section. Otherwise, continue to the next step.
 2. Create a new group and add your user as a member of that group.
-3. Create a new policy and provide that group a cloud-shell access:
+3. Create a new policy and provide that group a Cloud Shell access:
    ```
    Allow group '<my_cloud_shell_access_group>' to use cloud-shell in tenancy
    ```
 4. Verify that it works by opening Cloud Shell from the OCI Console.
 
 ### Retrieve the oci-basic-setup subdirectory from the helidon-labs repository
-The materials for this exercise will be located in the [oci-basic-setup](https://github.com/helidon-io/helidon-labs/tree/main/hols/oci-basic-setup) subdirectory of the  [helidon-labs](https://github.com/helidon-io/helidon-labs) repository, hence only that specific subdirectory will be cloned.
+The materials for this exercise are located in the [oci-basic-setup](https://github.com/helidon-io/helidon-labs/tree/main/hols/oci-basic-setup) subdirectory of the  [helidon-labs](https://github.com/helidon-io/helidon-labs) repository, so only that specific subdirectory needs to be cloned.
 1. Open a Cloud Shell terminal and make sure you are in the home directory
    ```shell
    cd ~
    ```
-2. Use `git sparsecheckout` to check out only the `oci-basic-setup` directory from the helidon-labs repository.
+2. Use `git sparsecheckout` to check out only the `oci-basic-setup` directory from the `helidon-labs` repository.
    ```shell
    git init helidon-labs
    cd helidon-labs 
@@ -39,7 +39,7 @@ The materials for this exercise will be located in the [oci-basic-setup](https:/
    echo ".gitignore" >> .git/info/sparse-checkout
    git pull --depth=1 origin main
    ```
-3. The previous step will pull all the required Terraform and Bash script files into the  `~/helidon-labs/hols/oci-basic-setup` directory that will be needed to perform various operations to complete this exercise.
+3. The previous step pulls all the required Terraform and Bash script files into the  `~/helidon-labs/hols/oci-basic-setup` directory that is required to perform the various operations in this exercise.
 
 ### Prepare the OCI infrastructure environment
 The goal of this task is to prepare a basic infrastructure environment comprised of a Compartment, Dynamic Groups, Policies, Compute and Virtual Cloud Network. This section requires a user with administrator privilege.
@@ -70,12 +70,12 @@ The goal of this task is to prepare a basic infrastructure environment comprised
    ```shell
    cd ~
    ```  
-2. Download and unzip the helidon cli generic distribution
+2. Download and unzip the Helidon CLI generic distribution
    ```shell
    curl -L -O https://github.com/helidon-io/helidon-build-tools/releases/download/3.0.6/helidon-cli.zip
    unzip helidon-cli.zip
    ```
-3. Make sure that JDK 21 exist in the path.
+3. Make sure that JDK 21 exists in the path.
 4. Execute the cli to generate a Helidon Microprofile application project.
    ```shell
    ~/helidon-3.0.6/bin/helidon init
@@ -116,7 +116,7 @@ The goal of this task is to prepare a basic infrastructure environment comprised
     ```shell
     ~/helidon-labs/hols/oci-basic-setup/update_config_values.sh ~/oci-mp
     ```
-    Invoking this script will perform the following:
+    Invoking this script performs the following:
     1. Updates the `~/oci-mp/server/src/main/resources/application.yaml` config file to set up a Helidon feature that sends Helidon generated metrics to the OCI monitoring service.
        1. compartmentId - The Compartment OCID used for this demo.
        2. namespace - This can be any string but for this demo, will be set to `helidon_metrics`.
@@ -125,7 +125,7 @@ The goal of this task is to prepare a basic infrastructure environment comprised
        2. oci.monitoring.namespace - This can be any string but for this demo, this will be set to `helidon_application`.
        3. oci.logging.id - Application log id that was provisioned by the terraform scripts.
 
-    **Note:** Make sure to validate that `application.yaml` and `microprofile-config.properties` have been updated by checking that the mentioned config parameters were properly populated.
+    **Note:** Make sure to validate that `application.yaml` and `microprofile-config.properties` were updated by checking that the mentioned config parameters were properly populated.
 12. To prepare for the build, ensure that JDK 21 and Maven 3.8+ exist and are set in the PATH environment variable of the Cloud Shell terminal.
 13. Build the application.  
     ```shell
@@ -150,19 +150,19 @@ The goal of this task is to prepare a basic infrastructure environment comprised
        export ENDPOINT_IP=$(~/helidon-labs/hols/oci-basic-setup/get.sh public_ip)
        echo "Instance public ip is $ENDPOINT_IP"
        ```
-    2. Test Hello world request.
+    2. Test the Hello world request.
        ```shell
        curl http://$ENDPOINT_IP:8080/greet
        ```
-       results to:
+       results in:
        ```shell
        {"message":"Hello World!","date":[2025,4,29]}
        ```
     3. Test Hello to a name, i.e. to `Joe`.
        ```shell
        curl http://$ENDPOINT_IP:8080/greet/Joe
        ```
-       results to:
+       results in:
        ```shell
        {"message":"Hello Joe!","date":[2025,4,29]}
        ```
@@ -171,7 +171,7 @@ The goal of this task is to prepare a basic infrastructure environment comprised
        curl -X PUT -H "Content-Type: application/json" -d '{"greeting" : "Hola"}' http://$ENDPOINT_IP:8080/greet/greeting 
        curl http://$ENDPOINT_IP:8080/greet
        ```
-       results to:
+       results in:
        ```shell
        {"message":"Hola World!","date":[2025,4,29]}
        ```
@@ -188,8 +188,8 @@ The goal of this task is to prepare a basic infrastructure environment comprised
    2. Change `Compartment` with a value that has the format of `devops-compartment-helidon-demo-<4 char random value>`.
    3. Under `Filters`, change `Log Group` to `app-log-group-helidon-demo`.
    4. Choose and click on `app-log-helidon-demo` from the Logs table.
-   5. Choose `Filter by time` value within the scope of your last request. For example, you can choose `Today` to see all request that was made today.
-   6. The `Explore Log` display should output some graphs of the logging activity and below it will also show a list of the logs that has been captured.
+   5. Choose `Filter by time` value within the scope of your last request. For example, you can choose `Today` to see all requests that were made today.
+   6. The `Explore Log` display should output graphs of the logging activity. Below the graphs, it will also show a list of the logs that have been captured.
 
 ### Cleanup
 When the environment is no longer needed, all the OCI resources can be cleaned up by following these steps: