[csswg-drafts] What defines the various fields in the property definition blocks?

bzbarsky has just created a new issue for https://github.com/w3c/csswg-drafts:

== What defines the various fields in the property definition blocks? ==
This is sort of crosscutting across all CSS specs that define properties.

Say I am looking at https://drafts.csswg.org/css-logical-props/#logical-dimension-properties and I see it says "Media: visual".  What does that actually mean?  What other values could there be?  Where is this defined?  I see no link in this draft to a definition of the "Media" thing.  Of course it also doesn't explain what "Inherited" means (or where it's defined), what "Initial" means, what "Canonical order" means, etc, etc.

Ideally all of those labels would be links to the relevant specs that define them.  At the very least, links to such specs should be _somewhere_ like the "Document conventions" section or something.  It's possible they're in the "Normative References" section; certainly the one for "initial" is (it's <https://www.w3.org/TR/css-cascade-3/>).  But I checked the obvious things like "Media Queries" and "Media Queries Level 4" and "CSS 2.1", and none of them really define what the "Media" thing means in a property description, nor what a "visual" value means.

@dbaron @tabatkins @fantasai 

Please view or discuss this issue at https://github.com/w3c/csswg-drafts/issues/1139 using your GitHub account

Received on Wednesday, 29 March 2017 04:27:11 UTC