[webrtc-stats] Confusing use of the terms defined and undefined (#737)

jan-ivar has just created a new issue for https://github.com/w3c/webrtc-stats:

== Confusing use of the terms defined and undefined ==
The terms _"defined"_, _"undefined"_, the JS value `undefined`, and member present/omitted/[exists](https://infra.spec.whatwg.org/#map-exists) are different concepts.

This spec appears to be using these terms interchangeably in some places. For example, [encoderImplementation](https://w3c.github.io/webrtc-stats/#dom-rtcoutboundrtpstreamstats-encoderimplementation) says:
- "Only defined when [exposing hardware is allowed](https://w3c.github.io/webrtc-stats/#dfn-exposing-hardware-is-allowed). ... Only [exist](https://infra.spec.whatwg.org/#map-exists)s for video."

Here the term [exists](https://infra.spec.whatwg.org/#map-exists) is well-defined, but "defined" is not (no pun intended). There's no way to tell what it means, but I suspect what was meant was:
- "Only [exists](https://infra.spec.whatwg.org/#map-exists) for video when [exposing hardware is allowed](https://w3c.github.io/webrtc-stats/#dfn-exposing-hardware-is-allowed)."

See https://github.com/w3c/webrtc-stats/issues/736#issuecomment-1452556494 for how the concepts differ.

Action items:
1. I count 4 hits for _"Only defined"_, which should probably be _"Only [exists](https://infra.spec.whatwg.org/#map-exists)"_ (plural seems better)
2. Most other hits for "defined" seem to be correct (references to where something is _specified_) but I could have missed some.
3. The 14 hits for "undefined" are more suspect. I see phrases like _"Calculated as defined in section 6.4.1. of [[RFC3550](https://w3c.github.io/webrtc-stats/#bib-rfc3550)]. If no [RTCP Receiver Report](https://w3c.github.io/webrtc-stats/#dfn-receiver-report) is received with a DLSR value other than 0, the round trip time is left undefined"_

Please view or discuss this issue at https://github.com/w3c/webrtc-stats/issues/737 using your GitHub account

Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Thursday, 2 March 2023 21:33:40 UTC