Update README.md

janbodnar · web-flow · commit e01b4d7ce508 · 2019-08-16T14:53:32.000+02:00
diff --git a/web/httpclient/README.md b/web/httpclient/README.md
@@ -18,15 +18,15 @@ It supports sending requests both synchronously and asynchronously by calling it
 respectively. A *Builder* is provided to create an instance. Once the client is created, the instance is immutable.
 *  **HttpRequest**: It encapsulates an HTTP request, including the target URI, the method (GET, POST, DELETE), headers and other information. 
 A request is constructed using a builder, is immutable once created, and can be sent multiple times.
-*  **HttpRequest.BodyPublisher**: If a request has a body (e.g. in POST requests), this is the entity responsible for publishing 
-the body content from a given source, for instance, from a string or a file.
-*  **HttpResponse**: It encapsulates an HTTP response, including headers and a message body, if any. This is what the client 
-receives after sending an *HttpRequest*.
-* **HttpResponse.BodyHandler**: It is a functional interface that accepts some information about the response (status code and headers), 
-and returns a *BodySubscriber*, which itself handles consuming the response body.
+*  **HttpRequest.BodyPublisher**: It converts high-level Java objects into a flow of byte buffers suitable for sending 
+as a request body froom a given source, such as a string or a file.
+*  **HttpResponse**: It encapsulates an HTTP response, including headers and a message body, if any. The client it receives after sending an *HttpRequest*.
+* **HttpResponse.BodyHandler**: It handles response bodies. It is a functional interface that allows inspection of the response 
+code and headers, before the actual response body is received, and returns a *BodySubscriber*, which itself handles consuming the response body.
 * **HttpResponse.BodySubscriber**: It subscribes for the response body and consumes its bytes into some other form (a string, a file, 
 or some other storage type).
 
+
 *BodyPublisher* is a subinterface of *Flow.Publisher*, introduced in Java 9. Similarly, *BodySubscriber* is a subinterface 
 of *Flow.Subscriber*. These interfaces are adjusted with the reactive streams approach, which is suitable 
 for sending asynchronous requests using HTTP/2.
