content/client-server-api/modules/end_to_end_encryption.md

@@ -1564,11 +1564,11 @@ before inviting him.
 Only room keys which were marked as "shareable" by the creator of the
 encryption session should be shared with new users.
 
-When a user wants to send a message in an encrypted room, their client first
+When Alice wants to send a message in the room she shares with Bob, she first
 checks the [history visibility](#room-history-visibility) state of the
-room. If it is `shared` or `world_readable`, then when the client sends the Megolm
+room. If it is `shared` or `world_readable`, then when she sends the Megolm
-keys to room members via [`m.room_key`](#mroom_key) messages, it SHOULD set
+keys to Bob via an [`m.room_key`](#mroom_key) message, she sets
-`shared_history` to `true`. Otherwise, it SHOULD set `shared_history` to `false`.
+`shared_history` to `true`.
 
 If the history visibility changes in a way that would affect the
 `shared_history` flag (i.e., it changes from `joined` or `invited` to `shared`

data/event-schemas/schema/m.room_key.yaml

@@ -29,7 +29,7 @@ properties:
         x-addedInMatrixVersion: "1.19"
         type: boolean
         description: |
-          `true` indicates that the creator of this encryption key considers that
+          `true` indicates that the creator of this encryption considers that
           the session is [shareable](/client-server-api/#shareable-encryption-sessions):
           in other words, the sender has observed that the [room history
           visibility](/client-server-api/#room-history-visibility) is set to