Re: [w3c/clipboard-apis] Add clipboard IDL description. (#158)

@mbrodesser commented on this pull request.



> +
+  Some platforms may support having more than one [=clipboard item=] at a time on the [=Clipboard=], while other platforms replace the previous [=clipboard item=] with the new one. 
+
+  A [=clipboard item=] has a <dfn>list of representations</dfn>, each <dfn>representation</dfn> with an associated [=mime type=] and <dfn>data</dfn>.
+
+  <p class=note>
+   In the example where the user copies a range of cells from a spreadsheet, it may be represented as an image (image/png), an HTML table (text/html), or plain text (text/plain).
+  </p>
+
+  Each of these [=mime type=]s describe a different [=representation=] of the same [=clipboard item=] at different levels of fidelity and make the [=clipboard item=] more consumable by target applications during paste.
+
+  <p class=note>
+   Making the range of cells available as an image will allow the user to paste the cells into a photo editing app, while the text/plain format can be used by text editor apps.
+  </p>
+
+  A [=clipboard item=] can also optionally have a <dfn>presentation style</dfn> that helps distinguish whether apps "pasting" a [=clipboard item=] should insert the contents of an appropriate [=representation=] inline at the point of paste or if it should be treated as an attachment.

This sentence doesn't define the term `presentation style`. A term X defined via`<dfn>X</dfn>` is defined by the enclosing text, see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dfn. Shouldn't there only be one definition (which really is a definition) of the term "presentation style"? See also https://pr-preview.s3.amazonaws.com/w3c/clipboard-apis/pull/158.html#index-defined-here which shows multiple terms for "presentation style" with and without space and capital/non-capital letters.
Moreover, the presentation style isn't optional: if not overridden, it's "undefined" via `ClipboardItemOptions`.

Presumably, the marked sentence should be replaced by something like
`<p>A clipboard item has an associated <dfn ...>presentation style</dfn> which is a PresentationStyle.</p>`.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/w3c/clipboard-apis/pull/158#pullrequestreview-827459997