[w3c/clipboard-apis] New terminology: ClipboardItem entry as data type → value. (#127)

Right now, the spec refers to two things as "items":

- A list of `ClipboardItem`s.
- The individual data values inside a single `ClipboardItem`.

This is rather confusing, so this PR proposes to rename the latter to
"entries", where an entry conceptually corresponds to a data type (e.g.
`"text/string"`) that maps to a value (e.g. a Blob). This:

- Matches the JS naming convention (think of `Object.entries`).
- Does not change any spec semantics, only the names of some identifiers.

In addition, this PR also renames:

- `ClipboardItemDataType` → `ClipboardItemValue`, and
- `ClipboardItemData` → `ClipboardItemValuePromise`.

This matches the "entry is a type type mapping to a value" convention,
and makes it clear what is a Promise. The previous names may have caused
a semantic typo (https://github.com/w3c/clipboard-apis/pull/126).

Closes #????

The following tasks have been completed:

 * [ ] Confirmed there are no ReSpec/BikeShed errors or warnings.
 * [ ] Modified Web platform tests (link to pull request)

Implementation commitment:

 * [ ] WebKit (https://bugs.webkit.org/show_bug.cgi?id=)
 * [ ] Chromium (https://bugs.chromium.org/p/chromium/issues/detail?id=)
 * [ ] Gecko (https://bugzilla.mozilla.org/show_bug.cgi?id=)


<!--
    This comment and the below content is programatically generated.
    You may add a comma-separated list of anchors you'd like a
    direct link to below (e.g. #idl-serializers, #idl-sequence):

    Don't remove this comment or modify anything below this line.
    If you don't want a preview generated for this pull request,
    just replace the whole of this comment's content by "no preview"
    and remove what's below.
-->
***
<a href="https://pr-preview.s3.amazonaws.com/lgarron/clipboard-apis/pull/127.html" title="Last updated on Jun 25, 2020, 10:49 AM UTC (4d7c705)">Preview</a> | <a href="https://pr-preview.s3.amazonaws.com/w3c/clipboard-apis/127/b56441b...lgarron:4d7c705.html" title="Last updated on Jun 25, 2020, 10:49 AM UTC (4d7c705)">Diff</a>
You can view, comment on, or merge this pull request online at:

  https://github.com/w3c/clipboard-apis/pull/127


-- Commit Summary --

  * New terminology: ClipboardItem entry as data type → value.

-- File Changes --

    M index.bs (28)

-- Patch Links --

https://github.com/w3c/clipboard-apis/pull/127.patch

https://github.com/w3c/clipboard-apis/pull/127.diff


-- 
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/127