PR feedback

api/client-server/create_room.yaml

@@ -173,15 +173,9 @@ paths:
               is_direct:
                 type: boolean
                 description: |-
-                  This flag shows that the intent for this room is to be a
+                  This flag makes the server set the is_direct flag on the
-                  one-to-one 'direct' conversation with the invitee. The
+                  m.room.member events sent to the users in invite and
-                  invitee's client should indicate this in the UI to the user,
+                  invite_3pid. See (Direct Messaging) for more information.
-                  as should the inviter. This is to keep the intent for new rooms
-                  synchronised at first. Both users may subsequently choose to
-                  tag the room differently.
-                  This adds an ``is_direct`` flag to the content of any invites
-                  sent, which will appear in the content of the `m.room.member`_
-                  event.
       responses:
         200:
           description: Information about the newly created room.

specification/modules/dm.rst

@@ -17,7 +17,7 @@ Direct Messaging
 
 .. _module:dm:
 
-All communications over Matrix happens within a room. It is sometimes
+All communication over Matrix happens within a room. It is sometimes
 desireable to offer users the concept of speaking directly to one
 particular person. This module defines a way of marking certain rooms
 as 'direct chats' with a given person. This does not restrict the chat