diff --git a/src/models/room-state.ts b/src/models/room-state.ts
index 745b2a5aa..b6f4d0744 100644
--- a/src/models/room-state.ts
+++ b/src/models/room-state.ts
@@ -78,6 +78,8 @@ export enum RoomStateEvent {
 export type RoomStateEventHandlerMap = {
     /**
      * Fires whenever the event dictionary in room state is updated.
+     * This does not guarantee that any related objects (like RoomMember) have been updated.
+     * Use RoomStateEvent.Update for that.
      * @param event - The matrix event which caused this event to fire.
      * @param state - The room state whose RoomState.events dictionary
      * was updated.