chore: Clean up the guide

Author: lqiu96

docs/endpoint.md

@@ -1,6 +1,6 @@
 # Client Library Endpoint
 Google Client libraries will automatically resolve an endpoint to connect to Google Cloud services. 
-The default resolved endpoint will be to Google servers (i.e. `https://{serviceName}.googleapis.com:443`).
+The default resolved endpoint will be to Google servers (i.e. `https://speech.googleapis.com:443`).
 
 ## Anatomy of an Endpoint
 Using the default Java-Speech endpoint as an example: `https://speech.googleapis.com:443`:
@@ -9,23 +9,23 @@ Using the default Java-Speech endpoint as an example: `https://speech.googleapis
 |----------	|--------------	|-----------------	|------	|
 | https:// 	| speech       	| googleapis.com  	| 443  	|
 
-Default values for client libraries:
+Default values for Java SDK Client libraries:
 - Scheme: https://
 - [Universe Domain](universe_domain.md): googleapis.com
 - Port: 443
 
-Service Name doesn't have a default value. This is different for each cloud service.
+Note: Service Name does not have a default value and is different for each cloud service.
 
 ## Configuring a Specific Endpoint
 There are two ways to configure the endpoint in Java Client Libraries: ServiceSettings and
 TransportChannelProvider.
 
-### Set through the generated {Service}Settings
+### (Recommended) Set through the generated {Service}Settings
 The following example is using Java-KMS v2.42.0 as an example:
 
 1. Set the endpoint in {Service}Settings.Builder and create the Settings object
 ```java
-String endpoint = "settingsendpoint.com";
+String endpoint = "settingsEndpoint.com";
 KeyManagementServiceSettings keyManagementServiceSettings =
   KeyManagementServiceSettings.newBuilder()
     .setEndpoint(endpoint)
@@ -35,17 +35,17 @@ KeyManagementServiceSettings keyManagementServiceSettings =
 ```java
 try (KeyManagementServiceClient keyManagementServiceClient =
   KeyManagementServiceClient.create(keyManagementServiceSettings)) {
+  ...
+}
 ```
-The endpoint will be resolved to `settingsendpoint.com`.
-
-Note: This is the recommend way to set the endpoint.
+The endpoint will be resolved to `settingsEndpoint.com`.
 
 ### Set through the Instantiating{Transport}ChannelProvider
 The following example is using Java-KMS v2.42.0 as an example:
 
 1. Create the transport specific TransportChannelProvider
 ```java
-String endpoint = "transportendpoint.com";
+String endpoint = "transportEndpoint.com";
 InstantiatingGrpcChannelProvider instantiatingGrpcChannelProvider =
     InstantiatingGrpcChannelProvider.newBuilder()
     .setEndpoint(endpoint)
@@ -63,10 +63,12 @@ KeyManagementServiceSettings keyManagementServiceSettings =
 ```java
 try (KeyManagementServiceClient keyManagementServiceClient =
   KeyManagementServiceClient.create(keyManagementServiceSettings)) {
+  ...
+}
 ```
-The endpoint will be resolved to `transportendpoint.com`.
+The endpoint will be resolved to `transportEndpoint.com`.
 
-### Set through both ways
+### Set through ServiceSettings and TransportChannelProvider
 If you are setting an endpoint via both methods above, like:
 ```java
 String endpoint1 = "transportEndpoint.com";
@@ -83,25 +85,31 @@ KeyManagementServiceSettings keyManagementServiceSettings =
     .setTransportChannelProvider(instantiatingGrpcChannelProvider)
     .build();
 ```
-The endpoint will be resolved to `transportendpoint.com`.
+The endpoint will be resolved to `transportEndpoint.com`.
 
 ### Endpoint Hierarchy
 1. If set in the TransportChannelProvider, use this value. Otherwise, go to the next step.
 2. If set via the ClientSettings, use this value. Otherwise, go to the next step.
 3. Use the default endpoint (i.e. `https://{serviceName}.googleapis.com:443`)
 
-### How can I confirm the endpoint the library is using
+#### How can I check which endpoint the client library is using
 Assuming you have configured a custom endpoint, like: 
 ```java
 String endpoint = "...";
 KeyManagementServiceSettings keyManagementServiceSettings =
   KeyManagementServiceSettings.newBuilder()
     .setEndpoint(endpoint)
     .build();
+try (KeyManagementServiceClient keyManagementServiceClient = 
+  KeyManagementServiceClient.create(keyManagementServiceSettings)) {
+  ...
+}
 ```
 
-You can retrieve the endpoint from the Setting's `getEndpoint()` method. This will return
-the resolved endpoint back.
+Retrieve the resolved endpoint from the Setting's `getEndpoint()` method
+```java
+keyManagementServiceClient.getSettings().getEndpoint();
+```
 
 ## When should I specify my custom endpoint
 There are a few use cases:

docs/universe_domain.md

@@ -15,7 +15,7 @@ is using Java-KMS v2.42.0 as an example:
 
 1. Set the endpoint in {Service}Settings.Builder and create the Settings object
 ```java
-String universeDomain = "myuniversedomain.com";
+String universeDomain = "myUniverseDomain.com";
 KeyManagementServiceSettings keyManagementServiceSettings =
   KeyManagementServiceSettings.newBuilder()
     .setUniverseDomain(universeDomain).build();
@@ -24,26 +24,28 @@ KeyManagementServiceSettings keyManagementServiceSettings =
 ```java
 try (KeyManagementServiceClient keyManagementServiceClient =
   KeyManagementServiceClient.create(keyManagementServiceSettings)) {
+  ...
+}
 ```
 
 With this configuration, the client library will resolve the endpoint to be:
-`https://cloudkms.myuniversedomain.com:443`.
+`https://cloudkms.myUniverseDomain.com:443`.
 
 ### Set through an Environment Variable
-Set the Universe Domain to the `GOOGLE_CLOUD_UNIVERSE_DOMAIN`. If set, Java client libraries
-will read this value and use it.
+Set the Universe Domain to the `GOOGLE_CLOUD_UNIVERSE_DOMAIN`. If set, Java client libraries 
+use this value.
 
 ### Universe Domain Hierarchy
 1. If set in the ClientSettings, use this value. Otherwise, go to the next step.
 2. If set via the Environment Variable, use this value. Otherwise, go to the next step.
-3. Use the GDU value
+3. Use the GDU value (i.e Universe Domain is set to be `googleapis.com`)
 
 ### Configuring a Specific Universe Domain and a Custom Endpoint
 The following example is using Java-KMS v2.42.0 as an example:
 
 1. Set the endpoint in {Service}Settings.Builder and create the Settings object
 ```java
-String endpoint = "settingsendpoint.com";
+String endpoint = "settingsEndpoint.com:443";
 String universeDomain = "universeDomain.com";
 KeyManagementServiceSettings keyManagementServiceSettings =
   KeyManagementServiceSettings.newBuilder()
@@ -52,10 +54,10 @@ KeyManagementServiceSettings keyManagementServiceSettings =
     .build();
 ```
 
-- The resolved endpoint is: `settingsendpoint.com`
+- The resolved endpoint is: `settingsEndpoint.com:443`
 - The resolved Universe Domain is: `universeDomain.com`
 
-The custom set endpoint triumphs over other configurations.
+The custom set endpoint triumphs over any other configurations.
 
 ### How can I confirm the universe domain the library is using
 Assuming you have configured a custom endpoint, like:
@@ -65,10 +67,16 @@ KeyManagementServiceSettings keyManagementServiceSettings =
   KeyManagementServiceSettings.newBuilder()
     .setUniverseDomain(universeDomain)
     .build();
+try (KeyManagementServiceClient keyManagementServiceClient =
+  KeyManagementServiceClient.create(keyManagementServiceSettings)) {
+  ...
+}
 ```
 
-You can retrieve the endpoint from the Setting's `getUniverseDomain()` method. This will return
-the resolved Universe Domain back.
+Retrieve the endpoint from the Setting's `getUniverseDomain()` method.
+```java
+keyManagementServiceClient.getSettings().getUniverseDomain();
+```
 
 ## Universe Domain Compatibility with
 ### ... DirectPath