From 200212ffd741be53beec8fea1de1100826d44c66 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Mon, 25 May 2020 08:33:08 -0600
Subject: [PATCH] Clarify that a creation event and member event are needed for
 createRoom

Fixes https://github.com/matrix-org/matrix-doc/issues/2494
---
 api/client-server/create_room.yaml               | 16 +++++++++++-----
 .../newsfragments/2571.clarification             |  1 +
 2 files changed, 12 insertions(+), 5 deletions(-)
 create mode 100644 changelogs/client_server/newsfragments/2571.clarification

diff --git a/api/client-server/create_room.yaml b/api/client-server/create_room.yaml
index 2487707e..446d8aef 100644
--- a/api/client-server/create_room.yaml
+++ b/api/client-server/create_room.yaml
@@ -38,20 +38,26 @@ paths:
         the new room, including checking power levels for each event. It MUST
         apply the events implied by the request in the following order:
 
-        0. A default ``m.room.power_levels`` event, giving the room creator
+        1. The ``m.room.create`` event itself. Must be the first event in the
+           room.
+
+        2. An ``m.room.member`` event for the creator to join the room. This is
+           needed so the remaining events can be sent.
+
+        3. A default ``m.room.power_levels`` event, giving the room creator
            (and not other members) permission to send state events. Overridden
            by the ``power_level_content_override`` parameter.
 
-        1. Events set by the ``preset``. Currently these are the ``m.room.join_rules``,
+        4. Events set by the ``preset``. Currently these are the ``m.room.join_rules``,
            ``m.room.history_visibility``, and ``m.room.guest_access`` state events.
 
-        2. Events listed in ``initial_state``, in the order that they are
+        5. Events listed in ``initial_state``, in the order that they are
            listed.
 
-        3. Events implied by ``name`` and ``topic`` (``m.room.name`` and ``m.room.topic``
+        6. Events implied by ``name`` and ``topic`` (``m.room.name`` and ``m.room.topic``
            state events).
 
-        4. Invite events implied by ``invite`` and ``invite_3pid`` (``m.room.member`` with
+        7. Invite events implied by ``invite`` and ``invite_3pid`` (``m.room.member`` with
            ``membership: invite`` and ``m.room.third_party_invite``).
 
         The available presets do the following with respect to room state:
diff --git a/changelogs/client_server/newsfragments/2571.clarification b/changelogs/client_server/newsfragments/2571.clarification
new file mode 100644
index 00000000..e9437f3c
--- /dev/null
+++ b/changelogs/client_server/newsfragments/2571.clarification
@@ -0,0 +1 @@
+Clarify which events are created as part of ``/createRoom``.