- From: Jan-Ivar Bruaroey via GitHub <sysbot+gh@w3.org>
- Date: Thu, 02 Mar 2023 21:33:38 +0000
- To: public-webrtc@w3.org
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