Expand docs about retries (#2311)

Co-authored-by: Tom Christie <tom@tomchristie.com>

diff --git a/docs/advanced.md b/docs/advanced.md
index 5da53118c0f8de0fb30417ccb3a5122782b9675f..64bd5fc58c3c0573203734225d4ccfe9cc8731b8 100644 (file)
--- a/docs/advanced.md
+++ b/docs/advanced.md
@@ -1093,7 +1093,7 @@ class directly, and pass it to the client instance. One example is the
 >>> client = httpx.Client(transport=transport)
 ```
 
-Connection retries are also available via this interface.
+Connection retries are also available via this interface. Requests will be retried the given number of times in case an `httpx.ConnectError` or an `httpx.ConnectTimeout` occurs, allowing smoother operation under flaky networks. If you need other forms of retry behaviors, such as handling read/write errors or reacting to `503 Service Unavailable`, consider general-purpose tools such as [tenacity](https://github.com/jd/tenacity).
 
 ```pycon
 >>> import httpx