From 70aa4b9231d8b1412fbff91a83d31a468c5d7d87 Mon Sep 17 00:00:00 2001 From: Kegan Dougal Date: Tue, 2 Sep 2014 21:45:36 +0100 Subject: [PATCH] Edited room creation section to mention all the events created when the room is. --- docs/specification.rst | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/specification.rst b/docs/specification.rst index 07b57ef2ab..20e7a0d85f 100644 --- a/docs/specification.rst +++ b/docs/specification.rst @@ -351,7 +351,6 @@ Rooms Creation -------- .. TODO kegan - - TODO: This creates a room creation event which serves as the root of the PDU graph for this room. - TODO: Key for invite these users? To create a room, a client has to use the |createRoom|_ API. There are various options @@ -412,6 +411,22 @@ Example:: "topic": "All about happy hour" } +The home server will create a ``m.room.create`` event when the room is +created, which serves as the root of the PDU graph for this room. This +event also has a ``creator`` key which contains the user ID of the room +creator. It will also generate several other events in order to manage +permissions in this room. This includes: + + - ``m.room.power_levels`` : Sets the authority of the room creator. + - ``m.room.join_rules`` : Whether the room is "invite-only" or not. + - ``m.room.add_state_level`` + - ``m.room.send_event_level`` : The power level required in order to + send a message in this room. + - ``m.room.ops_level`` : The power level required in order to kick or + ban a user from the room. + +See `Room Events`_ for more information on these events. + Modifying aliases ----------------- .. NOTE::