[webrtc-stats] Clarify stats hierarchies

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

== Clarify stats hierarchies ==
We've ended up with multiple hierarchies and it's not obvious how everything fits together.
We should add an introductory section and/or structure the sections to follow the hierarchies.

I'm talking about:
```
RTCRTPStreamStats
  RTCReceivedRTPStreamStats
    RTCInboundRTPStreamStats
    RTCRemoteInboundRTPStreamStats
  RTCSentRTPStreamStats
    RTCOutboundRTPStreamStats
    RTCRemoteOutboundRTPStreamStats
```

And after https://github.com/w3c/webrtc-stats/pull/322:
```
DICTIONARY NAME                          | INSTANCE FOUND BY
-----------------------------------------+--------------------------------------
RTCMediaHandlerStats                     | N/A
  RTCAudioHandlerStats                   | N/A
    RTCAudioSenderStats                  | kind == 'audio' && type == 'sender' 
      RTCSenderAudioTrackAttachmentStats | kind == 'audio' && type == 'track'
    RTCAudioReceiverStats                | kind == 'audio' && type == 'receiver'
  RTCVideoHandlerStats                   | N/A
    RTCVideoSenderStats                  | kind == 'video' && type == 'sender'
      RTCSenderVideoTrackAttachmentStats | kind == 'video' && type == 'track'
    RTCVideoReceiversStats               | kind == 'video' && type == 'receiver'
```

Currently, all of these are just listed one after another and it's up to the reader to figure out their relationships to one another.

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

Received on Wednesday, 7 February 2018 13:59:47 UTC