Re: [whatwg/streams] JSIDL vs WebIDL (#45)

I doubt IDL is still being considered at this point, but I talked a bit with @smaug---- trying to get through the issues he has reading the specification.

I think in part it's because the "class description" lacks a lot of the context IDL gives.

IDL tells you what arguments (types) are and what members end up returning (again types). These bits of information often make it very clear what the flow of a class is like and help understand how things fit together.

If we could convey that somehow in a "class description" I think that'd be a huge help.

The other thing I found personally lacking is links from the "class description" members to where they are defined.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/streams/issues/45#issuecomment-255363252