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

Define "descriptor" and "property" somewhere #5633

Closed
gsnedders opened this issue Oct 19, 2020 · 3 comments
Closed

Define "descriptor" and "property" somewhere #5633

gsnedders opened this issue Oct 19, 2020 · 3 comments

Comments

@gsnedders
Copy link
Member

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:

Declarations are further categorized as "properties" or "descriptors", with the former typically appearing in qualified rules and the latter appearing in at-rules. (This categorization does not occur at the Syntax level; instead, it is a product of where the declaration appears, and is defined by the respective specifications defining the given rule.)

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!

@svgeesus
Copy link
Contributor

svgeesus commented Oct 20, 2020

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
W3C Working Draft 21-July-1997

But hey, CSS1 was pretty hazy about properties too:

Style sheets influence the presentation of documents by assigning values to style properties. This section lists the defined style properties, and their corresponding list of possible values, of CSS1.

@svgeesus
Copy link
Contributor

This is something I tend to need to cover when presenting about webfonts.

@fantasai
Copy link
Collaborator

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

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