[webrtc-pc] Remove "MAY generate statistics that are not documented." (#2844)

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

== Remove "MAY generate statistics that are not documented." ==
[ยง 8.6 Mandatory To Implement Stats](https://www.w3.org/TR/webrtc/#mandatory-to-implement-stats) normatively references stats that MUST be implemented for [conformance](https://www.w3.org/TR/webrtc/#conformance) with this spec.

However, the section ends by saying:
1. _"An implementation MAY support generating any other statistic defined in [[WEBRTC-STATS](https://w3c.github.io/webrtc-pc/#bib-webrtc-stats)],"_
2. _"and MAY generate statistics that are not documented."_

2 reads as the WG sanctioning undocumented APIs, which I think we should refrain from. On 1, I don't see a reason to limit documented extension to [[WEBRTC-STATS](https://w3c.github.io/webrtc-pc/#bib-webrtc-stats)]. AFAIK any spec may extend existing APIs unless the base spec explicitly forbids it.

I think the purpose here was to help clarify for readers where the conformance criteria end, which seems doable with a note. E.g. _"Note: implementations might generate additional statistics beyond the ones above, as defined in other specifications such as [[WEBRTC-STATS](https://w3c.github.io/webrtc-pc/#bib-webrtc-stats)]."_

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


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

Received on Tuesday, 21 March 2023 21:19:56 UTC