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.

Sign up for GitHub

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

Jump to bottom

References needs a thorough overhaul #514

Closed
svgeesus opened this issue Aug 4, 2018 · 11 comments
Closed

References needs a thorough overhaul #514

svgeesus opened this issue Aug 4, 2018 · 11 comments
Assignees
@svgeesus
Labels
Appendices Entire spec SVG2
Milestone
SVG 2.0 Proposed ...

Comments

@svgeesus
Copy link
Contributor

svgeesus commented Aug 4, 2018

The references all need to be checked for

  • actual use in the spec
  • normative vs. informative
  • links to latest published version

This sort of thing is done automatically by tools like bikeshed, but needs to be periodically done manually here.

See also #71 #227 #365
@svgeesus svgeesus self-assigned this Aug 4, 2018
@svgeesus
Copy link
Contributor Author

svgeesus commented Aug 5, 2018

Hopefully fixed by #515

@svgeesus
Copy link
Contributor Author

Normative Refs includes Document Object Model (DOM) Level 2 Views Specification

Document Status Update 2011-09-22: This paragraph is informative. The concepts this document defines are obsolete. The 'document' and 'defaultView' attributes are defined in the HTML5 specification with simplified semantics. The Web Applications Working Group encourages implementation of these concepts as defined by HTML5.

I don't find DOM Views in HTML5 (or in DOM LS either).

@svgeesus
Copy link
Contributor Author

I don't understand why we have references to both HTML 5.1 2nd Edition and also HTML LS. Can refs to the former simply be converted to reference the latter? Is there some specific W3C-only functionality that we need (and is implemented)?

@svgeesus
Copy link
Contributor Author

W3C URL spec says

Work on this document has been discontinued and it should not be referenced or used as a basis for implementation.

Replacing with direct link to URL LS.

@svgeesus
Copy link
Contributor Author

Do we really still have a normative dependency on Synchronized Multimedia Integration Language (SMIL 3.0) ?

@svgeesus
Copy link
Contributor Author

Wondering whether WOFF 2 should be added, alongside WOFF 1?

@AmeliaBR
Copy link
Contributor

I don't understand why we have references to both HTML 5.1 2nd Edition and also HTML LS.

Because no one has gone through and updated all the references & links to W3C HTML to point to their matching places in WHATWG. I don't think there are any details we need to reference that are only in the W3C versions.

Do we really still have a normative dependency on Synchronized Multimedia Integration Language (SMIL 3.0) ?

It looks like we still have definitions of SMIL-related events in interact.html. (Probably should see if those can be safely moved to the separate animations module.)

The other thing that is borrowed from SMIL is <switch>, and we have a normative reference for the allowReorder behavior. So at the very least the ref should stay for that.

Wondering whether WOFF 2 should be added, alongside WOFF 1?

Possibly as an informative ref? Right now we say that WOFF (level 1) support is required, it would be a normative change to bump that up to WOFF2.

@svgeesus
Copy link
Contributor Author

Wondering why we reference DOM Level 1

svgeesus added a commit that referenced this issue Aug 21, 2018
@svgeesus
normative references updated, for #514
d467d9b
@svgeesus
Copy link
Contributor Author

I don't understand why we have references to both HTML 5.1 2nd Edition and also HTML LS.

Because no one has gone through and updated all the references & links to W3C HTML to point to their matching places in WHATWG. I don't think there are any details we need to reference that are only in the W3C versions.

Okay, I will go through and do that.

svgeesus added a commit that referenced this issue Sep 17, 2018
@svgeesus
Change from HTML 5.1 to HTML LS, #514
de901a5
@svgeesus
Copy link
Contributor Author

Okay, I will go through and do that.

#544

svgeesus added a commit that referenced this issue Sep 21, 2018
@svgeesus
Change from HTML 5.1 to HTML LS, #514 (#544)
913662b 
* Change from HTML 5.1 to HTML LS, #514

* animation frames

* semantics-embedded-content links

* more HTML5.1

* canvas

* canvas

* style element

* html namespace

* the a element

* fallback content

* parsing urls

* base url

* browsing the web

* valid browsing context name

* potential cors

* browsers

* document object

* the link element

* global attrs

* events table

* focus

* tabindex focusable

* browsing context container

* tabindex attr

* activation behavior (now in DOM LS)

* accesskey

* top level browsing context

* cross origin

* base element (again)

* link, meta, style, script elements

* remove dangling ref-html51 links

* link to this PR
@svgeesus
Copy link
Contributor Author

I think this can be closed now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@svgeesus svgeesus

Labels
Appendices Entire spec SVG2
Projects
None yet
Milestone
SVG 2.0 Proposed Recommendation
Development

No branches or pull requests
2 participants
@svgeesus @AmeliaBR