diff --git a/specification/modules/instant_messaging.rst b/specification/modules/instant_messaging.rst
index 43a06aa1..619226df 100644
--- a/specification/modules/instant_messaging.rst
+++ b/specification/modules/instant_messaging.rst
@@ -3,6 +3,9 @@ Instant Messaging
 
 .. _module:im:
 
+This module adds support for sending human-readable messages to a room. It also
+adds human-readable information to the room itself such as a room name and topic.
+
 Events
 ------
 
@@ -15,7 +18,7 @@ Events
 {{m_room_topic_event}}
 
 m.room.message msgtypes
------------------------
+~~~~~~~~~~~~~~~~~~~~~~~
 
 .. TODO-spec
    How a client should handle unknown message types.
@@ -27,3 +30,13 @@ outlined below.
 
 {{msgtype_events}}
 
+
+Client behaviour
+----------------
+
+Server behaviour
+----------------
+
+Security considerations
+-----------------------
+