diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst
index cef9e088d8..d78be35a79 100644
--- a/docs/user/quickstart.rst
+++ b/docs/user/quickstart.rst
@@ -548,6 +548,11 @@ to hang indefinitely::
     received on the underlying socket for ``timeout`` seconds). If no timeout is specified explicitly, requests do
     not time out.
 
+    A single ``timeout`` value applies to both the **connect** and
+    **read** phases separately. To set them independently, pass a
+    ``(connect_timeout, read_timeout)`` tuple. See :ref:`timeouts`
+    for details.
+
 
 Errors and Exceptions
 ---------------------