accepting README.md suggestion

Co-authored-by: Ryan Uber <ru@ryanuber.com>
hashicorp · Apr 13, 2022 · c9eb34c · c9eb34c
1 parent 5081362
commit c9eb34c
Showing 1 changed file with 1 addition and 1 deletion.
diff --git a/README.md b/README.md
@@ -47,7 +47,7 @@ call would block and retry with exponential backoff.
 
 ## Retrying cases that fail after a seeming success
 
-It's possible for a request to succeed, but then for later processing to fail, and sometimes this requires retrying the full request. E.g. a GET that returns a lot of data may "succeed" but the connection may drop while reading all of the data.
+It's possible for a request to succeed in the sense that the expected response headers are received, but then to encounter network-level errors while reading the response body. In go-retryablehttp's most basic usage, this error would not be retryable, due to the out-of-band handling of the response body. In some cases it may be desirable to handle the response body as part of the retryable operation.
 
 In such a case, you can use `DoWithResponseHandler` (or `GetWithResponseHandler`) rather than `Do` (or `Get`). A toy example (which will retry the full request and succeed on the second attempt) is shown below: