Adds docstring

Author: willingc

jupyter_client/blocking/client.py

@@ -16,8 +16,19 @@
 from jupyter_client.client import KernelClient
 from .channels import ZMQSocketChannel
 
+
 class BlockingKernelClient(KernelClient):
+    """A BlockingKernelClient """
+    
     def wait_for_ready(self, timeout=None):
+        """Waits for a response when a client is blocked
+        
+        - Sets future time for timeout
+        - Blocks on shell channel until a message is received
+        - Exit if the kernel has died
+        - If client times out before receiving a message from the kernel, send RuntimeError
+        - Flush the IOPub channel
+        """
         if timeout is None:
             abs_timeout = float('inf')
         else: