6456 webclient doc part2 4.x

docs/se/webclient.adoc

@@ -99,7 +99,7 @@ WebClient offers a set of request methods that are used to specify the type of a
 * `put()`
 * `method(String methodName)`
 
-Check out link:{webclient-javadoc-base-url}.api/io/helidon/webclient/api/HttpClient.html[HttpClient.html] API to learn more about request methods. These methods will create a new instance of link:{webclient-javadoc-base-url}.api/io/helidon/webclient/api/HttpClientRequest.html[HttpClientRequest] which can then be configured to add optional settings that will customize the behavior of the request.
+Check out link:{webclient-javadoc-base-url}.api/io/helidon/webclient/api/HttpClient.html[HttpClient] API to learn more about request methods. These methods will create a new instance of link:{webclient-javadoc-base-url}.api/io/helidon/webclient/api/HttpClientRequest.html[HttpClientRequest] which can then be configured to add optional settings that will customize the behavior of the request.
 
 === Customizing the Request
 
@@ -147,8 +147,8 @@ ClientResponseTyped<String> response = webClient.get()
 String entityString = response.entity();
 ----
 
-=== Protocol used
-Webclient currently supports `HTTP/1.1` and `HTTP/2` protocols. Below are the rules on which specific protocol will be used:
+=== Protocol Used
+WebClient currently supports `HTTP/1.1` and `HTTP/2` protocols. Below are the rules on which specific protocol will be used:
 
 * Using plain socket triggers WebClient to process a request using `HTTP/1.1`.
 * When using TLS, the client will use ALPN (protocol negotiation) to use appropriate HTTP version (either 1.1, or 2). `HTTP/2` has a higher weight, so it is chosen if supported by both sides.
@@ -162,7 +162,7 @@ String result = webClient.get()
 * If `HTTP/2` is used, an upgrade attempt will be performed. If it fails, the client falls-back to `HTTP/1.1`.
 * The parameter `prior-knowledge` can be defined using `HTTP/2` protocol configuration. Please refer to <<Setting Protocol configuration>> on how to customize `HTTP/2`. In such a case, `prior-knowledge` will be used and fail if it is unable to switch to `HTTP/2`.
 
-=== Adding Media Support to the WebClient
+=== Adding Media Support
 
 Webclient supports the following built-in Helidon Media Support libraries:
 
@@ -237,9 +237,6 @@ Webclient provides three DNS resolver implementations out of the box:
 </dependency>
 ----
 
-=== Adding Service
-
-
 == Configuring the WebClient
 
 The class responsible for WebClient configuration is:
@@ -385,8 +382,7 @@ Config config = Config.create();
 WebClient webClient = WebClient.create(config.get("webclient"));
 ----
 
-
-=== WebClient TLS setup
+=== WebClient TLS Setup
 
 Configure TLS either programmatically or by the Helidon configuration framework.
 
@@ -423,7 +419,10 @@ webclient:
         resource:
           resource-path: "client.p12"
 ----
-Then, in your application code, load the configuration from that file.
+
+NOTE: The `passphrase` value on the config file can be encrypted if stronger security is required. For more information on how secrets can be encrypted using a master password and store them in a configuration file, please see xref:{rootdir}/mp/security/configuration-secrets.adoc[Configuration Secrets].
+
+In the application code, load the settings from the configuration file.
 
 [source,java]
 .WebClient initialization using the `application.yaml` file located on the classpath