Update kop/java/README.md

Co-authored-by: Huanli Meng <48120384+Huanli-Meng@users.noreply.github.com>

Author: Demogorgon314

kop/java/README.md

@@ -69,22 +69,24 @@ See [KoP Security](https://github.com/streamnative/kop/blob/master/docs/security
 
 ## Example: OAuth2 authentication 
 
-See [KoP Security](https://github.com/streamnative/kop/blob/master/docs/security.md#oauthbearer) for how to configure KoP with oauth authentication. This example takes a topic named `my-topic` under `public/default` namespace as reference.
-1. Start the hydra OAuth2 Server
+See [KoP Security](https://github.com/streamnative/kop/blob/master/docs/security.md#oauthbearer) for how to configure KoP with OAuth authentication. This example takes a topic named `my-topic` under `public/default` namespace as reference.
+1. Start the Hydra OAuth2 server.
 
-Start hydra server
+Start the Hydra OAuth2 server.
 ```shell
 docker-compose -f $(git rev-parse --show-toplevel)/kop/java/src/main/resources/hydra/docker-compose.yml up -d
 ```
-Init the hydra server
+Initialize the Hydra OAuth2 server.
 ```shell
 ./$(git rev-parse --show-toplevel)/kop/java/src/main/resources/init_hydra_oauth_server.sh
 ```
 
 2. Configure the oauth in Pulsar
 
-In this example it will use the follow value:
-> Need replace the privateKey value to your local credentials_file.json path.
+This example will use the follow values:
+> **Note**
+>
+> You need to replace the `privateKey` value with your local path to your `credentials_file.json` file.
 ```properties
 # Enable the authentication
 authenticationEnabled=true
@@ -105,7 +107,7 @@ authorizationEnabled=true
 authorizationProvider=org.apache.pulsar.broker.authorization.PulsarAuthorizationProvider
 ```
 
-3. Create a new oauth client
+3. Create a new OAuth2 client.
 
 ```shell
 docker run --rm \
@@ -121,7 +123,7 @@ docker run --rm \
     --audience http://example.com/api/v2/
 ```
 
-4. Create the credentials file json calls `credentials.json`
+4. Create a credentials file json named `credentials.json`
 
 ```properties
 {
@@ -139,11 +141,11 @@ docker run --rm \
      --actions produce,consume
    ```
 
-> **NOTE**
+> **Note**
 >
 > The `conf/client.conf` should be configured. For details, see [Configure CLI Tools](http://pulsar.apache.org/docs/en/security-jwt/#cli-tools).
 
-6. Configure the oauth in [oauth.properties](src/main/resources/oauth.properties).
+6. Configure OAuth2 authentication parameters in [oauth.properties](src/main/resources/oauth.properties).
 
    ```properties
    bootstrap.servers=localhost:9092
@@ -184,10 +186,10 @@ docker run --rm \
    Receive record: hello from persistent://public/default/my-topic-0@0
    ```
 
-10. Stop the hydra server
+10. Stop the Hydra OAuth2 server.
 
 ```shell
 docker-compose -f $(git rev-parse --show-toplevel)/kop/java/src/main/resources/hydra/docker-compose.yml down
 ```
 
-11. Stop the Pulsar server
+11. Stop the Pulsar server.