diff --git a/proposals/1767-extensible-events.md b/proposals/1767-extensible-events.md index 2c1fa251..8500af94 100644 --- a/proposals/1767-extensible-events.md +++ b/proposals/1767-extensible-events.md @@ -90,14 +90,15 @@ a minimum, a `m.markup` content block: ``` `m.markup` has the following definitions associated with it: -* An ordered array of mimetypes and applicable string content to represent a single +* An *unordered* array of mimetypes and applicable string content to represent a single marked-up blob of text. Each element is known as a representation. * `body` in a representation is required, and must be a string. * `mimetype` is optional in a representation, and defaults to `text/plain`. * Zero representations are permitted, however senders should aim to always specify at least one. * Invalid representations are skipped by clients (missing `body`, not an object, etc). -* The first representation a renderer understands should be used. +* The client can choose which representation fits its purpose best, though generally + the preferred representations should appear first in the array. * Senders are strongly encouraged to always include a plaintext representation, however are equally permitted to send an HTML representation instead. * The `mimetype` of a representation determines its `body` - no effort is made to