diff --git a/docs/source/development/messaging.rst b/docs/source/development/messaging.rst
index 74a5a02..d224698 100644
--- a/docs/source/development/messaging.rst
+++ b/docs/source/development/messaging.rst
@@ -1020,7 +1020,15 @@ Message type: ``input_reply``::
 
     content = { 'value' : str }
     
-.. Note::
+.. note::
+
+    The stdin socket of the client is required to have the same zmq IDENTITY
+    as the client's shell socket.
+    Because of this, the ``input_request`` must be sent with the same IDENTITY
+    routing prefix as the ``execute_reply`` in order for the frontend to receive
+    the message.
+
+.. note::
 
    We do not explicitly try to forward the raw ``sys.stdin`` object, because in
    practice the kernel should behave like an interactive program.  When a