[csswg-drafts] [css-contain] editorial: Paint Containment description is incomprehensible (#4946)

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

== [css-contain] editorial: Paint Containment description is incomprehensible ==
ISSUE 1:
The [Paint Containment](https://drafts.csswg.org/css-contain/#containment-paint) section says (1st bullet):
> The contents of the element including both the paint of the descendants and their geometry ...

The term "_the paint of the descendants_" is unfamiliar to me and I can't find any definition of it in any CSS spec.
The term "_geometry_" is unfamiliar to me and I can't find any definition of it in any CSS spec.
 (I really have no clue what you mean by either of those in this context.)

Please provide precise definitions of what you mean by these terms, or preferably, use well-known CSS terms that are defined in other specifications such as: _scrollable overflow_, _ink overflow_, _content-box size_, _border-box size_ etc... (please also linkify at least the first use of such terms for extra clarity). Thanks!

ISSUE 2:
The last sentence under the 1st bullet reads: "_This is as if `overflow: visible` was changed to `overflow: clip` at used value._". What does "this" refer to in that sentence? Is it the whole paragraph, or just the preceding sentence, or perhaps just the first sentence?
The only interpretation that makes sense to me is that it refers to the first sentence, since a scrolling mechanism is never created for `overflow:clip`. If so, then it seems better to insert this sentence directly after the first sentence. Or perhaps just re-write the first sentence with "`overflow:visible` behaves as `overflow:clip`" included in some way. (Again, it's better to use a familiar term like "behaves as" than trying to mint your own version of it.)


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

Received on Sunday, 12 April 2020 01:32:16 UTC