add documentation for the server & client side timeout

Signed-off-by: Priyanka Saggu <priyankasaggu11929@gmail.com>

Author: Priyankasaggu11929

examples/pod_namespace_watch.py

@@ -31,6 +31,25 @@ def main():
     v1 = client.CoreV1Api()
     count = 10
     w = watch.Watch()
+    """
+    [INFO: `server-side` & `client-side` timeout]
+
+    `kwargs['timeout_seconds'] = n`:
+       - It is a server-side timeout, i.e. a polite request to the server,
+         mentioning it to cleanly close the connection after n seconds.
+       - If the user have a network outage, then this parameter will do nothing.
+       - The client will hang indefinitely without raising an exception.
+       - You can set this number much higher, maybe to 3600 seconds (1h).
+
+    `kwargs['_request_timeout'] = n`:
+       - It is a client-side timeout, configuring the user's local socket.
+       - If the user have a network outage, resulting into dropping all packets 
+         with no RST/FIN, the value of n will specify, for how long
+         the client would wait before realizing the network outage,
+         & dropping the connection.
+       - The connection will drop, followed by raising an exception.
+       - You can keep this number low.
+    """
     for event in w.stream(v1.list_namespace, timeout_seconds=10):
         print("Event: %s %s" % (event['type'], event['object'].metadata.name))
         count -= 1