Amplifies the timeout warning in the docs.

Partially addresses #3070.
2026-06-05 23:10:16 +00:00 · 2016-11-14 09:57:08 -08:00
parent 33bd38be15
commit cfb7fd8f28
1 changed files with 3 additions and 1 deletions
@@ -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):