W3C home > Mailing lists > Public > public-css-archive@w3.org > December 2017

[csswg-drafts] [css-position-3] Typos/Issues in the Sticky Positioning section

From: Tyler via GitHub <sysbot+gh@w3.org>
Date: Sun, 31 Dec 2017 01:38:59 +0000
To: public-css-archive@w3.org
Message-ID: <issues.opened-285234356-1514684338-sysbot+gh@w3.org>
Tyler-H has just created a new issue for https://github.com/w3c/csswg-drafts:

== [css-position-3] Typos/Issues in the Sticky Positioning section ==
In [Sticky Positioning](https://www.w3.org/TR/css-position-3/#sticky-pos), I've noticed quite a few grammatical errors/incomprehensible passages. Each one is contained in a quote block, followed by my remarks and/or replacement suggestions.

> A stickily positioned box establishes **a new a new** containing block [...] 

(redundant phrase outlined in bold).

I recommend rewriting the entire sentence:
> For stickily positioned elements, left, right, top and bottom are offsets from the respective edges of its flow box which are used to constrain the element’s offset. 

To:

> For a stickily positioned element, left, right, top, and bottom are [offsets which are] used to define the element's offset from the respective edges of its flow box.

(The bit in brackets is optional; I think the passage works well, if not better, without it). 

Also, the term "flow box" is very esoteric, and never explicitly defined. It took me something like 15 minutes to intuit that it is just the containing block. Could we just replace instances of 'flow box' here with 'containing block'?

This would also facilitate the improved readability of the following paragraph:

> 1. A rectangle is computed relative to the containing block of the stickily positioned element, by insetting its flow box rectangle on each side by offsets computed from the left, right, top and bottom properties of the stickily positioned element. 

By rewriting it as:

> 1. A rectangle is computed relative to the containing block of the stickily positioned element by insetting the rectangle on each side by offsets computed from the left, right, top, and bottom properties of the stickily positioned element.

...which I think reads much better.

> When computing **containement** of the stickily positioned element within its containing block

(extra e in containment)

> Note that a stickily positioned element with non-auto top style and auto bottom style will only ever be pushed down by sticky positioning; it will never be offset upward**s**.

(The actual spelling is upward. Upwards is a variant that's taken hold due to some folks' tendency to add an 's' to directional words like "upward, forward, backward, onward, toward". Unfortunately I didn't catch this error in time for animation-fill-mode properties, but luckily this is just prose, not a keyword)





Please view or discuss this issue at https://github.com/w3c/csswg-drafts/issues/2152 using your GitHub account
Received on Sunday, 31 December 2017 01:39:02 UTC

This archive was generated by hypermail 2.4.0 : Tuesday, 5 July 2022 06:41:21 UTC