Skip to content

References needs a thorough overhaul #514

Closed

Description

@svgeesus

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

Activity

  1. self-assigned this
    on Aug 4, 2018
  2. svgeesus commented on Aug 5, 2018

    @svgeesus
    ContributorAuthor

    Hopefully fixed by #515

  3. svgeesus commented on Aug 20, 2018

    @svgeesus
    ContributorAuthor

    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).

  4. svgeesus commented on Aug 20, 2018

    @svgeesus
    ContributorAuthor

    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)?

  5. svgeesus commented on Aug 20, 2018

    @svgeesus
    ContributorAuthor

    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.

  6. svgeesus commented on Aug 20, 2018

    @svgeesus
    ContributorAuthor

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

  7. svgeesus commented on Aug 20, 2018

    @svgeesus
    ContributorAuthor

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

  8. AmeliaBR commented on Aug 20, 2018

    @AmeliaBR
    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.

  9. svgeesus commented on Aug 21, 2018

    @svgeesus
    ContributorAuthor

    Wondering why we reference DOM Level 1

  10. svgeesus commented on Aug 21, 2018

    @svgeesus
    ContributorAuthor

    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.

  11. svgeesus commented on Sep 18, 2018

    @svgeesus
    ContributorAuthor

    Okay, I will go through and do that.

    #544

  12. added a commit that references this issue on Sep 21, 2018
  13. svgeesus commented on Sep 22, 2018

    @svgeesus
    ContributorAuthor

    I think this can be closed now.

  14. deleted a comment from mauryusme on Feb 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions