Amplifies the timeout warning in the docs.

Partially addresses psf#3070.
mlissner · Nov 14, 2016 · cfb7fd8 · cfb7fd8
1 parent 33bd38b
commit cfb7fd8
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst
@@ -484,7 +484,9 @@ Timeouts
 --------
 
 You can tell Requests to stop waiting for a response after a given number of
-seconds with the ``timeout`` parameter::
+seconds with the ``timeout`` parameter. Nearly all production code should use 
+this parameter in nearly all requests. Failure to do so can cause your program
+to hang indefinitely::
 
     >>> requests.get('http://github.com', timeout=0.001)
     Traceback (most recent call last):