Skip to content

Commit aaad820

Browse files
committed
[css-flexbox] Clarify purpose of Flex Baselines section, since it confuses everybody who reads it.
1 parent 80f1618 commit aaad820

File tree

2 files changed

+9
-2
lines changed

2 files changed

+9
-2
lines changed

css-flexbox/Overview.bs

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2077,7 +2077,11 @@ Packing Flex Lines: the 'align-content' property</h3>
20772077
<h3 id="flex-baselines">
20782078
Flex Baselines</h3>
20792079

2080-
The baselines of a flex container are determined as follows (after reordering with 'order'):
2080+
In order for a <a>flex container</a> to itself <a href="#baseline-participation">participate in baseline alignment</a>
2081+
(e.g. when the <a>flex container</a> is itself a <a>flex item</a> in an outer <a>flex container</a>),
2082+
it needs to submit the position of the baseline that will rest represent its contents.
2083+
To this end,
2084+
the baselines of a flex container are determined as follows (after reordering with 'order'):
20812085

20822086
<dl>
20832087
<dt><dfn export>main-axis baseline</dfn>

css-flexbox/Overview.html

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2054,7 +2054,10 @@ <h3 class="heading settled" data-level="8.4" id="align-content-property"><span c
20542054
<p class="caption"> An illustration of the <a class="property" data-link-type="propdesc" href="#propdef-align-content">align-content</a> keywords and their effects on a <a data-link-type="dfn" href="#multi-line">multi-line</a> flex container. </p>
20552055
</div>
20562056
<h3 class="heading settled" data-level="8.5" id="flex-baselines"><span class="secno">8.5. </span><span class="content"> Flex Baselines</span><a class="self-link" href="#flex-baselines"></a></h3>
2057-
<p>The baselines of a flex container are determined as follows (after reordering with <a class="property" data-link-type="propdesc" href="#propdef-order">order</a>):</p>
2057+
<p>In order for a <a data-link-type="dfn" href="#flex-container">flex container</a> to itself <a href="#baseline-participation">participate in baseline alignment</a> (e.g. when the <a data-link-type="dfn" href="#flex-container">flex container</a> is itself a <a data-link-type="dfn" href="#flex-item">flex item</a> in an outer <a data-link-type="dfn" href="#flex-container">flex container</a>),
2058+
it needs to submit the position of the baseline that will rest represent its contents.
2059+
To this end,
2060+
the baselines of a flex container are determined as follows (after reordering with <a class="property" data-link-type="propdesc" href="#propdef-order">order</a>):</p>
20582061
<dl>
20592062
<dt><dfn data-dfn-type="dfn" data-export="" id="main-axis-baseline">main-axis baseline<a class="self-link" href="#main-axis-baseline"></a></dfn>
20602063
<dd>

0 commit comments

Comments
 (0)