[css-houdini-drafts] [css-typed-om] introduction to CSSNumericValue should be clearer that list is interfaces inheriting from it from L. David Baron via GitHub on 2018-01-28 (public-houdini-archive@w3.org from January 2018)

From: L. David Baron via GitHub <sysbot+gh@w3.org>
Date: Sun, 28 Jan 2018 05:15:48 +0000
To: public-houdini-archive@w3.org
Message-ID: <issues.opened-292178083-1517116547-sysbot+gh@w3.org>

dbaron has just created a new issue for https://github.com/w3c/css-houdini-drafts:

== [css-typed-om] introduction to CSSNumericValue should be clearer that list is interfaces inheriting from it ==
The opening of the [section on CSSNumericValue](https://drafts.css-houdini.org/css-typed-om-1/#numeric-objects) says:

> CSSNumericValue objects represent CSS values that are numeric in nature (&lt;number>s, &lt;percentage>s, &lt;dimension>s).
>
> *   CSSUnitValue objects represent values that contain a single unit type (for example "42px").
>
> *   CSSMathValue objects represent math expressions, which can contain more than one value/unit (for example "calc(56em + 10%)").

This reads in a slightly confusing way, until I realized that the bulleted list was two interfaces that inherit from CSSNumericValue.  It would probably be a good bit clearer why this is structured the way it is (with three parallel sentences, but only the latter two in a list), by introducing the list with a sentence, such as "Two interfaces inherit from CSSNumericValue:"

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

Received on Sunday, 28 January 2018 05:15:55 UTC