-
Notifications
You must be signed in to change notification settings - Fork 672
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
Define "descriptor" and "property" somewhere #5633
Comments
Mea culpa, mea maxima culpa. The specification which introduced the term "descriptor" used it a ton of times and never once defined it. Web Fonts But hey, CSS1 was pretty hazy about properties too:
|
This is something I tend to need to cover when presenting about webfonts.
|
Ok, we've added dfns for property and descriptor and also improved the definition of declaration (and defined 'property declaration' and 'descriptor declaration') in be5e75b |
As far as I can tell, we don't actually
<dfn>
"descriptor" or "property" anywhere. We touch on this in Syntax, § 5 Parsing, defining declaration:It's come to my attention that some people who've been around for browsers for a long time don't understand the difference here, and we don't really ever make this super clear.
Looking at CSS Fonts for example: the only explicit clue between https://drafts.csswg.org/css-fonts/#font-family-prop and https://drafts.csswg.org/css-fonts/#font-family-desc is the titles of each section. We say the latter is "For:
@font-face
", but that's about it, and what exactly "For" means isn't totally clear.This ends up relevant in places like CSSOM where we talk about "supported CSS properties" but it doesn't cross-reference anything for what a property is!
The text was updated successfully, but these errors were encountered: