[css-box-3] Reference css-logical-1 in intro, shorten other references. w3c#5723

Author: fantasai

css-box-3/Overview.bs

@@ -48,10 +48,19 @@ Introduction {#intro}
 	'border' and its longhands,
 	and 'margin' and its longhands--
 	define the sizes of these other areas.
-	Margins and padding are defined in this module;
-	borders are defined in [[css-backgrounds-3]].
 
-	Note: This module <a href="https://www.w3.org/TR/2018/WD-css3-box-20180731/">originally contained</a>
+	[=Margins=] and [=padding=] are defined in this module.
+	[=Borders=] are similarly defined in [[css-backgrounds-3]].
+
+	Note: This module only defines the [=physical=] per-side [=longhand=] properties.
+	Additional, [=flow-relative=] [=longhand=] properties
+	are defined in [[css-logical-1]].
+	Note that both sets of [=longhand=] properties control the same [=margins=]/[=padding=]:
+	they are just different ways of indexing each side.
+
+	<details class="note">
+	<summary>History of CSS Box module and the definition of Block Layout</summary>
+	<p>This module <a href="https://www.w3.org/TR/2018/WD-css3-box-20180731/">originally contained</a>
 	the CSS Level 3 specification prose relating to
 	box generation (now defined in [[css-display-3]]),
 	the box model (defined here),
@@ -72,6 +81,7 @@ Introduction {#intro}
 	and <a href="https://www.w3.org/TR/css-tables/">Table Layout</a>,
 	in addition to Block Layout)
 	which each deserve their own parallel module.
+	</details>
 
 <h3 id="values">
 Value Definitions</h3>
@@ -270,13 +280,11 @@ Margins {#margins}
 	The 'margin' <a>shorthand property</a>
 	sets the margin for all four sides
 	while the margin <a>longhand properties</a> only set their respective side.
-	This specification defines the <a>physical</a> 'margin' <a>longhands</a>;
-	[[css-logical-1#margin-properties]] additionally
-	defines <a>flow-relative</a> 'margin' <a>longhands</a>.
-	Both sets of properties control the same set of margins:
-	they are just different ways of indexing each side.
+	This section defines the <a>physical</a> 'margin' <a>longhands</a>.
+	(Additional <a>flow-relative</a> 'margin' <a>longhands</a>
+	are defined in [[css-logical-1]].)
 
-	Note: Adjoining margins in <a>block layout</a> <em>collapse</em>.
+	Note: Adjoining margins in <a>block layout</a> can <em>collapse</em>.
 	See <a href="https://www.w3.org/TR/CSS2/box.html#collapsing-margins">CSS2&sect;8.3.1 Collapsing Margins</a>
 	for details.
 	Also, margins adjoining a <a>fragmentation break</a> are sometimes truncated.
@@ -363,11 +371,9 @@ Padding {#paddings}
 	The 'padding' <a>shorthand property</a>
 	sets the padding for all four sides
 	while the padding <a>longhand properties</a> only set their respective side.
-	This specification defines the <a>physical</a> 'padding' <a>longhands</a>;
-	[[css-logical-1#padding-properties]] additionally
-	defines <a>flow-relative</a> 'padding' <a>longhands</a>.
-	Both sets of properties control the same set of padding:
-	they are just different ways of indexing each side.
+	This section defines the <a>physical</a> 'padding' <a>longhands</a>.
+	(Additional <a>flow-relative</a> 'padding' <a>longhands</a>
+	are defined in [[css-logical-1]].)
 
 	Note: Backgrounds specified on the box
 	are by default laid out and painted within the padding edges.
@@ -451,12 +457,10 @@ Borders {#borders}
 	The <dfn export>border properties</dfn> specify the thickness
 	of the <a>border area</a> of a box,
 	as well as its drawing style and color.
-	See [[css-backgrounds-3#borders]] for the definition
-	of the physical variants of these properties;
-	[[css-logical-1#border-properties]] additionally
-	defines <a>flow-relative</a> border <a>longhands</a>.
-	Both sets of properties control the same set of borders:
-	they are just different ways of indexing each side.
+	See [[css-backgrounds-3]] for the definition of these properties,
+	including their [=physical=] longhands.
+	(Additional [=flow-relative=] border longhands
+	are defined in [[css-logical-1]].)
 
 Changes Since CSS Level 2 {#changes}
 =========================