search

wolenetz / mse-for-webcodecs

Explainer for additions to MSE API to support buffering and playing WebCodecs media
22 stars 1 forks source link

Move IDL to a draft spec doc? Expand considered alternatives? #2

Open slightlyoff opened 3 years ago

slightlyoff commented 3 years ago

Howdy all!

Excited to see this work moving forward and the explainer is in generally very helpful. It'd be helpful to perhaps follow the TAG's guidance on explainers in a few more detailed ways.

First, the TAG guidance explicitly suggests not having IDL in explainers. Given that a draft spec doc is in progress, perhaps that's a better place for that?

Similarly, it'd be great to see more example code to compare/contrast how folks have to do this sort of thing today and the advantages of this approach.

Lastly, seeing a fuller list of considered design alternatives (potentially with example code for each) would help observers understand the thinking that went into the API design.

Thanks again!

wolenetz commented 3 years ago

Great feedback! Regarding the IDL, from what I recall I was following along the lines of the ImageDecoder explainer, though I agree that more detail (spec, samples, considered approaches, what behavior is allowed versus potential polyfills before this feature) in the explainer (or linked from it) are all beneficial to the web platform and authors that would use this API.