Clarified the three main types of exceptions thrown in HttpClient

Adjusted docs

Author: Toflar

components/http_client.rst

@@ -436,7 +436,8 @@ Handling Exceptions
 
 When the HTTP status code of the response is in the 300-599 range (i.e. 3xx,
 4xx or 5xx) your code is expected to handle it. If you don't do that, the
-``getHeaders()`` and ``getContent()`` methods throw an appropriate exception::
+``getHeaders()`` and ``getContent()`` methods throw an appropriate exception, all of
+which implement the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`::
 
     // the response of this request will be a 403 HTTP error
     $response = $client->request('GET', 'https://httpbin.org/status/403');
@@ -476,6 +477,29 @@ component. No errors will be unnoticed: if you don't write the code to handle
 errors, exceptions will notify you when needed. On the other hand, if you write
 the error-handling code, you will opt-out from these fallback mechanisms as the
 destructor won't have anything remaining to do.
+=======
+
+Thus, there are two types of exceptions:
+
+* Exceptions implementing the ``HttpExceptionInterface`` are thrown when your code
+  does not handle the status codes in the 300-599 range.
+  When streaming responses, these exceptions do not interrupt the stream as you might
+  still want to read the content of these responses.
+  That being said, be aware that they are thrown on every single chunk.
+
+* ``TransportExceptionInterface`` exceptions signal a lower level issue.
+  Thus, when streaming responses, the exception will only be thrown once.
+
+There are three types of exceptions:
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface` are thrown when
+  your code does not handle the status codes in the 300-599 range.
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface` are thrown
+  when a lower level issue occurs.
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\DecodingExceptionInterface` are thrown
+  when a content-type cannot be decoded to the expected representation.
 
 Concurrent Requests
 -------------------