Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
marcoscaceres opened this issue May 28, 2021 · 3 comments
Open

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

marcoscaceres opened this issue May 28, 2021 · 3 comments
Assignees

Comments

@marcoscaceres
Copy link
Member

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
Copy link
Member

dontcallmedom commented Jun 2, 2021

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

  • dom-media-have_metadata
  • ended-playback
  • gains-focus
  • media-timeline
  • potentially-playing

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
Copy link
Member

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
Copy link
Member

@dontcallmedom Note #752 has since merged in case it unblocks this.

@jan-ivar jan-ivar added this to the Future Version milestone Feb 14, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants