Skip to content

Commit 5f4c648

Browse files
authored
Merge branch 'w3c:main' into main
2 parents 756797c + ba68cb3 commit 5f4c648

File tree

28 files changed

+3463
-1840
lines changed

28 files changed

+3463
-1840
lines changed

CONTRIBUTING.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,11 +39,30 @@ issues on a regular basis; however note that sometimes this can take awhile
3939
issue and the work schedules of people involved--this does not mean we are
4040
ignoring the issue.
4141

42-
For an issue that requires WG discussion or approval, WG members can tag/label
43-
it 'Agenda+' to bring it to the Working Group's attention. Unfortunately,
42+
When issues need WG discussion or approval, WG members should label the issue
43+
'Agenda+' to bring it to the Working Group's attention. Unfortunately,
4444
GitHub doesn't allow labelling permissions without repository write permissions,
4545
so if you believe an issue is urgent or discussion has stalled for awhile and
46-
the WG's attention is needed to move forward, ask one of the editors to flag it.
46+
the WG's attention is needed to move forward, ask one of the Editors to flag it.
47+
48+
In general, you should not directly commit changes to a draft unless you are an
49+
Editor of that draft, or have their explicit permission. If you are not an
50+
Editor of a draft, but wish to contribute changes, the best practice is to either
51+
work directly with an Editor to review proposed text, or file your proposal as a
52+
pull request (PR) originating from your own fork. Substantive changes
53+
need WG consensus, not merely Editor agreement; typographic error and markup fixes
54+
are generally okay to commit, but any substantive changes should have
55+
clear WG consensus. Substantial changes or additions to non-normative text
56+
should still have clear Editor approval.
57+
58+
In any case, WG consensus is expected prior to merging changes, and consensus is
59+
determined by the Chairs (not self-assessed) via synchronous decisions during
60+
meetings, and occasionally via async CFCs. Some degree of discretion is afforded
61+
to Editors to make changes prior to WG consensus, particularly early in a spec or
62+
feature's lifecycle, although Editors must confirm those changes with the WG
63+
prior to republishing on TR. References to the discussion and the WG consensus
64+
should be placed in the issue or commit. Agreement from an Editor in an issue
65+
is not a substitute for WG consensus.
4766

4867
The Working Group, aside from managing issues on GitHub, mainly discusses
4968
specifications and requests on [the www-style public mailing list](https://lists.w3.org/Archives/Public/www-style/),

css-anchor-position-1/Overview.bs

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -171,9 +171,10 @@ for a given positioned element.
171171
with the ''implicit'' keyword,
172172
rather than referring to some 'anchor-name' value.
173173

174-
A ''::before'', ''::after'' or ''::backdrop'' [=pseudo-element=]
175-
has the same [=implicit anchor element=]
176-
as its [=originating element=].
174+
[=Pseudo-element=]
175+
have the same [=implicit anchor element=]
176+
as its [=originating element=],
177+
unless otherwise specified.
177178

178179
Note: Without this, these [=pseudo-elements=], which are often inaccessible
179180
by other specifications, cannot be positioned with [=implicit anchor elements=].
@@ -267,6 +268,13 @@ or nothing (a missing specifier).
267268
before reaching |query el|'s [=containing block=]
268269
is either not [=absolutely positioned=]
269270
or precedes |query el| in the tree order.
271+
272+
* |el| is either an [=element=],
273+
or a [=pseudo-element=] that acts like one.
274+
275+
Issue: define the term that actually means this,
276+
matching ::before/after/backdrop/etc
277+
(but not ::marker/placeholder/etc whose box is not detectable).
270278
</div>
271279

272280
<!-- Big Text: default
@@ -308,22 +316,16 @@ in ''anchor()'' and ''anchor-size()''.
308316
<div class=example>
309317
For example, in the following code
310318
both ''.foo'' and ''.bar'' elements
311-
can use the same positioning properties and fallback,
319+
can use the same positioning properties,
312320
just changing the anchor element they're referring to:
313321

314322
<pre highlight=css>
315323
.anchored {
316324
position: absolute;
317-
position-fallback: --under-then-over;
318-
}
319-
320-
@position-fallback --under-then-over {
321-
@try {
322-
// No &lt;anchor-element> specified,
323-
// so it takes from 'anchor-default'.
324-
top: calc(.5em + anchor(outside));
325-
bottom: auto;
326-
}
325+
top: calc(.5em + anchor(outside));
326+
/* Since no anchor name was specified,
327+
this automatically refers to the
328+
default anchor element. */
327329
}
328330

329331
.foo.anchored {

0 commit comments

Comments
 (0)