autoplay icon indicating copy to clipboard operation
autoplay copied to clipboard

Add proposed explainer

Open beccahughes opened this issue 5 years ago • 18 comments

This is a proposed explainer for the W3C TAG review. This is not final and we should alter the design based on the resolution of the async vs sync issue (hence leaving this as a PR for now as it is easier to leave comments).

@mounirlamouri @padenot @jyavenard @eric-carlson @hober @jernoble

beccahughes avatar Mar 25 '19 23:03 beccahughes

Design review is here: https://github.com/w3ctag/design-reviews/issues/356

beccahughes avatar Mar 25 '19 23:03 beccahughes

I've posted my comment in #7, as originally planned. I think the layout of issue #7 is better at this stage of the discussion, as it present the three (really, two, iirc what happened in the meeting) alternatives without an explicit hierarchization: writing the examples in the async style and relegating the other API styles in another section.

padenot avatar Mar 26 '19 13:03 padenot

👋 hi! just checking in a seeing if anything is happening with this proposal/incubation? Is there consensus to move it forward?

marcoscaceres avatar Jun 27 '19 00:06 marcoscaceres

👋 hi! just checking in a seeing if anything is happening with this proposal/incubation? Is there consensus to move it forward?

The TAG remanded this issue to the Media WG. It is now part of the Media WG charter , so it should probably be moved from the WICG.

eric-carlson avatar Jun 27 '19 00:06 eric-carlson

clarification: the TAG review didn’t cause the venue change, @eric-carlson.

hober avatar Jun 27 '19 00:06 hober

Ok, cool... does that means moving the whole repository or will "the good parts" be moved into some existing spec?

marcoscaceres avatar Jun 27 '19 01:06 marcoscaceres

We should move the whole repo. We have a bunch of repo to move to w3c/ and I was waiting to hear from François Daoust to check how to do that as I assume I can't just drop repos in the w3c org :)

mounirlamouri avatar Jun 27 '19 13:06 mounirlamouri

Ok cool. Let me know which ones, and to which working groups, and we Chairs can help too. “Graduating” incubations to W3C Working Groups is our goal, so we are happy to help.

marcoscaceres avatar Jun 27 '19 14:06 marcoscaceres

Let's move over email instead of spamming this PR 😃

mounirlamouri avatar Jun 27 '19 14:06 mounirlamouri

Can we merge this PR? It would be good to have an explainer in place for when @alastor0325 is ready to create a spec.

chrisn avatar Jun 11 '21 15:06 chrisn

Where would this be merged?

the TAG reviewed and the decision was made to move the canautoplay detection synchronous, making most of this explainer obsolete..

jyavenard avatar Jun 11 '21 16:06 jyavenard

It's currently on a branch on this repo, so the idea would be to merge to main here. But, if the explainer doesn't reflect current thinking, we should redraft.

chrisn avatar Jun 11 '21 17:06 chrisn

I think we could just obsolete this explainer because it contains some async information that we won't use for the spec. I've already started editing the spec and will update the spec draft after we determine the final naming for API in #12.

alastor0325 avatar Jun 11 '21 17:06 alastor0325

I would recommend that we create an explainer in any case, as it will help as we go through W3C review process - and TAG will want to see it if and when we ask another TAG review.

chrisn avatar Jun 18 '21 16:06 chrisn

Yeah, an explainer on the need for both a document and a video element property would be helpful, I think.

gkatsev avatar Jun 18 '21 16:06 gkatsev

Close this PR because we have already started implement a draft (this explainer is based on old discussion, which is out-of-date)

alastor0325 avatar Jan 10 '22 18:01 alastor0325

Reopening, as we'll need the explainer when we request TAG review for https://github.com/w3c/autoplay/issues/30. I'll update it to reflect the draft spec API shape and remove the sync/async discussion.

chrisn avatar Apr 13 '22 15:04 chrisn

Some things still to add:

  • Describe the benefit to end-users, not just the benefit to web developers (TAG reviews often look for this)
  • Explain why we have per-element and per-document queries and when each should be used
  • Describe a Web Audio example

@alastor0325 @liberato-at-chromium for review, edits welcome.

chrisn avatar Apr 13 '22 16:04 chrisn