w3c / mediacapture-main

Media Capture and Streams specification (aka getUserMedia)
https://w3c.github.io/mediacapture-main/
Other
121 stars 61 forks source link

Use xref, avoid data-cite="html" #792

Open marcoscaceres opened 3 years ago

marcoscaceres commented 3 years ago

The spec uses data-cite="!HTML/#thing" in various places. With "xref", you can just link directly to things in the HTML spec (and other specs that are part of browser specs).

For xref usage, please see: https://respec.org/docs/#xref

dontcallmedom commented 3 years ago

This is being used for the following anchors at the moment:

Except for dom-media-have_metadata, these are all marked as private definitions at the moment, so not usable through xref which is why we've fallen back on doing it this way.

I'm not sure why dom-media-have_metadata doesn't show up in xref.

Getting these fixed upstream has been in my todo list, but admittedly not very high so far :)

I did file #795 to address a case that had no justification for not using xref.

dontcallmedom commented 3 years ago

for gain-focus, the real problem is that we're not targeting the proper definition in any case, which is tied to the discussion of #752

jan-ivar commented 6 months ago

@dontcallmedom Note https://github.com/w3c/mediacapture-main/issues/752 has since merged in case it unblocks this.