updated use of "size" vs. "margin box size" in layout algorithm

Author: alexmog1

css3-flexbox/Overview.src.html

@@ -966,7 +966,7 @@ <h2 id='layout-algorithm'>
 						<p>In column-direction flexbox, shrink-to-fit size of a flex item along the main axis 
 						is the extent in block direction that it gets when laid 
 						out using its &#39;fit-content&#39; as its size in inline 
-						direction, using cross-size of flexbox content box as 
+						direction and using cross-size of flexbox content box as 
 						available measure, also as defined in 
 						[[!CSS3-WRITING-MODES]]. </p>
 						<p>In multi-line column-direction flexbox, cross-size of the whole flexbox content box is used as available measure, not the share of individual flexbox line, to avoid a circular dependency of line breaks on shrink-to-fit calculations.</p>
@@ -999,7 +999,10 @@ <h2 id='layout-algorithm'>
 					</ul>
 				</li>
 
-				<li>Collect as many consecutive flexbox items as possible, starting from the first item, while keeping the sum of their main size smaller than the flexbox's available space.  If a flexbox item is sized with a flexible length, then for the purpose of this step, clamp the item's size between its minimum and maximum main sizes.  The items so collected form a single flexbox line.</li>
+				<li>Collect as many consecutive flexbox items as possible, starting from the first item, while keeping the sum of their 
+				margin-box main size smaller than the flexbox's available space. 
+				If a flexbox item is sized with a flexible length, then for the 
+				purpose of this step, clamp its size between its minimum and maximum main sizes.  The items so collected form a single flexbox line.</li>
 
 				<li>Repeat the previous step, starting each time from the first flexbox item not yet collected into a flexbox line, until all flexbox items have been collected into flexbox lines.</li>
 			</ol>
@@ -1072,8 +1075,7 @@ <h2 id='layout-algorithm'>
 		<li>Layout all items again in their final size and position. 
 		Implementations can determine when this step is needed and how it can be 
 		optimized, but for precise results it has to be assumed that this step 
-		is performed, because the layout of each item&#39;s content may change when 
-		ea</li>
+		is performed.</li>
 	</ol>
 
 	<p>To <dfn>resolve the flexible lengths</dfn> of the items within a flexbox line:</p>
@@ -1083,17 +1085,18 @@ <h2 id='layout-algorithm'>
 			Determine sign of flexibility
 
 			<ol>
-				<li>Add sizes of all items, <i>adjusted for min/max</i>.
+				<li>Add margin-box hypothetical main sizes of all items, <i>adjusted for min/max</i>.
 
-				<li>If sum of preferred sizes is less than available space, use positive flexibility, otherwise use negative flexibility.</li>
+				<li>If the sum is less than available space, use positive flexibility, otherwise use negative flexibility.</li>
 			</ol>
 
 			<p>for the rest of the algorithm use flexibility with the sign determined in this step</p>
 		</li>
 
 		<li>Reset all flexible sizes to their preferred size</li>
 
-		<li>Find free space by subtracting sum of item sizes from available space.</li>
+		<li>Find free space by subtracting sum of margin-box main sizes of 
+		flexbox items from available space.</li>
 
 		<li>
 			Distribute free space proportional to flex:
@@ -1201,12 +1204,14 @@ <h2 id="pagination">
 
 			<ol>
 				<li>
-					<p>If flexbox main-axis size is definite, flexbox algorithm must be run first, without constraints of available space on page and using all content of the flexbox. Otherwise items use the preferred size, adjusted for min/max.</p>
+					<p>If flexbox main-axis size is definite, flexbox algorithm must be run first, without constraints of available space on page and using all content of the flexbox. Otherwise 
+					flexbox items use the preferred size, adjusted for min/max.</p>
 
 					<p>If page size varies and flexbox size depends on page size, this step has to be repeated on each page, again with the whole content of the flexbox.</p>
 				</li>
 
-				<li>Set of items that will fit on current page is determined by adding main-axis sizes of items until total size exceeds 
+				<li>Set of items that will fit on current page is determined by adding main-axis 
+				margin-box sizes of flexbox items until total size exceeds 
 				available space or a forced break is encountered.</li>
 
 				<li>If border box of an item doesn’t fit in available space, a break inside the item is considered</li>
@@ -1254,7 +1259,7 @@ <h2 id="pagination">
 					<p>If page size varies and flexbox size depends on page size, this step needs to be repeated on each page.</p>
 				</li>
 
-				<li>Items are sized and positioned as usual, but in block-direction available space of min(remaining available space in flexbox, remaining space on the page).</li>
+				<li>Flexbox items are sized and positioned as usual, but in block-direction available space of min(remaining available space in flexbox, remaining space on the page).</li>
 
 				<li>Any items with baseline alignment must be aligned before considering breaks inside items.</li>
 
@@ -1267,7 +1272,8 @@ <h2 id="pagination">
 					<ol>
 						<li>For the purposes of cross-axis alignment, minimum of remaining available space in flexbox and available space at current page is used.</li>
 
-						<li>If an item is broken in the previous step and its alignment is not baseline, its cross-axis size is set to available space. If item alignment is baseline, its cross-axis size is adjusted so that it extends to exactly the end of available space.</li>
+						<li>If an item is broken in the previous step and its alignment is not baseline, its cross-axis 
+						margin-box size is set to available space. If item alignment is baseline, its cross-axis size is adjusted so that it extends to exactly the end of available space.</li>
 					</ol>
 				</li>
 			</ol>