diff --git a/event-schemas/schema/m.call.hangup b/event-schemas/schema/m.call.hangup
index 0328e03a..c0478f5a 100644
--- a/event-schemas/schema/m.call.hangup
+++ b/event-schemas/schema/m.call.hangup
@@ -1,6 +1,6 @@
 {
     "type": "object",
-    "description": "Sent by either party to signal their termination of the call. This can be sent either once the call has has been established or before to abort the call. The ``reason`` for the hangup is expected to be provided when there was an error in the call negotiation, such as ``ice_failed`` for when ICE negotiation fails or ``invite_timeout`` for when the other party did not answer in time.",
+    "description": "Sent by either party to signal their termination of the call. This can be sent either once the call has has been established or before to abort the call.",
     "allOf": [{
         "$ref": "core-event-schema/room_event.yaml"
     }],
@@ -18,7 +18,7 @@
                 },
                 "reason": {
                     "type": "string",
-                    "description": "Optional error reason for the hangup. This should not be provided when the user naturally ends or rejects the call.",
+                    "description": "Optional error reason for the hangup. This should not be provided when the user naturally ends or rejects the call. When there was an error in the call negotiation, this should be ``ice_failed`` for when ICE negotiation fails or ``invite_timeout`` for when the other party did not answer in time.",
                     "enum": [
                         "ice_failed",
                         "invite_timeout"