From fa7b6417d94fb1a19df291f260510c8a9261e3ed Mon Sep 17 00:00:00 2001
From: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
Date: Mon, 3 Apr 2023 11:17:15 +0100
Subject: [PATCH] clarifications for `users_default`

---
 data/event-schemas/schema/m.room.power_levels.yaml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/data/event-schemas/schema/m.room.power_levels.yaml b/data/event-schemas/schema/m.room.power_levels.yaml
index 7c778c55..f5f15fab 100644
--- a/data/event-schemas/schema/m.room.power_levels.yaml
+++ b/data/event-schemas/schema/m.room.power_levels.yaml
@@ -74,9 +74,11 @@ properties:
         type: object
       users_default:
         description: |-
-            The default power level for every user in the room, unless their
-            `user_id` is mentioned in the `users` key. Defaults to 0 if
+            The power level for users in the room whose `user_id` is not mentioned in the `users` key. Defaults to 0 if
             unspecified.
+
+            **Note**: When there is no `m.room.power_levels` event in the room, the room creator has
+            a power level of 100, and all other users have a power level of 0.     
         type: integer
       notifications:
         properties: