diff --git a/src/room/events.ts b/src/room/events.ts
index 378bc1dc71..4a6cf49bb5 100644
--- a/src/room/events.ts
+++ b/src/room/events.ts
@@ -252,7 +252,8 @@ export enum RoomEvent {
   SignalConnected = 'signalConnected',
 
   /**
-   * Recording of a room has started/stopped.
+   * Recording of a room has started/stopped. Room.isRecording will be updated too.
+   * args: (isRecording: boolean)
    */
   RecordingStatusChanged = 'recordingStatusChanged',
 }