[webrtc-pc] Minor inconsistencies around RTCSessionDescription vs. RTCSessionDescriptionInit

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

== Minor inconsistencies around RTCSessionDescription vs. RTCSessionDescriptionInit ==
I noticed some minor issues related to the use of `RTCSessionDescription` (the interface) and `RTCSessionDescriptionInit` (the dictionary):

- There's a section called "Set the RTCSessionSessionDescription". That's one too many "Session"s.
- This section talks about setting an `RTCSessionDescription`, but it's actually an `RTCSessionDescriptionInit` that goes into `setLocalDescription` and `setRemoteDescription`. Is there a missing "construct `RTCSessionDescription` from `RTCSessionDescriptionInit` step"?
- If we do go that route, then the constructor of `RTCSessionDescription` is no longer just for legacy purposes.

It may also be nice to explain somewhere in human-readable language _why_ we have two things. Is it just for legacy purposes? What are they, since `setLocalDescription` and `setRemoteDescription` no longer accept `RTCSessionDescription` as arguments? Or do they, because an `RTCSessionDescription` is capable of being converted to an `RTCSessionDescriptionInit`?


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

Received on Thursday, 13 July 2017 18:47:11 UTC