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

first paragraph about adopting constructed stylesheets should be clearer #50

Closed
dbaron opened this issue Oct 23, 2018 · 0 comments
Closed

Comments

@dbaron
Copy link
Contributor

dbaron commented Oct 23, 2018

The section on Using Constructed Stylesheets currently begins with the paragraph:

A CSSStyleSheet can only be applied to the Document it is constructed on (e.g. the document on which the factory function is called on), and any ShadowRoot in the Document it is constructed on, by assigning an array containing the sheet to their adoptedStyleSheets. So, a stylesheet can be used in multiple DocumentOrShadowRoots within the document it is constructed on.

This paragraph appears to be a sequence of statements of facts (see Hixie's post). In other words, it doesn't have any normative requirements. But it also doesn't cite any references for those statements of facts, which makes me suspect that it might be intending to impose normative requirements.

I think this should be reworded to either (a) more clearly impose the normative requirements that it intends or (b) cite sources (i.e., other specifications) for its statements of facts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants