[css-snappoints] Snap-alignment should be in the element section

Author: ChumpChief

css-snappoints/Overview.bs

@@ -259,9 +259,37 @@ Issue: <b>This spec is currently undergoing major changes in line with the resol
 
     This property is a shorthand property that sets all of the 'scroll-snap-padding-*' longhands in one declaration.
 
-<h3 id="scroll-snap-align">Scroll Snap Align: the 'scroll-snap-align' property</h3>
+<h2 id="properties-on-the-elements">Properties on the elements</h2>
+
+<h3 id="scroll-snap-margin">Scroll Snap Margin: the 'scroll-snap-margin' property</h3>
+
+    The 'scroll-snap-margin' property defines the <a>scroll snap margin</a> on elements within a <a>scroll container</a>, used in calculating <a>snap positions</a> for that scroll container.
+
+    <pre class="propdef">
+    Name: scroll-snap-margin
+    Value: <<length>>{1,4}
+    Initial: 0
+    Applies to: all elements
+    Inherited: no
+    Percentages: n/a
+    Media: interactive
+    Computed value: as specified, with lengths made absolute
+    Animatable: yes
+    </pre>
+
+    <dl dfn-type=value dfn-for="scroll-snap-margin">
+        <dt><dfn><<length>>{1,4}</dfn>
+        <dd>
+            Specifies the outset of the element's snap margin from the axis-aligned bounding box of the transformed border box, in the <a>scroll container's</a> coordinate space.  Outsets are applied to this bounding box, not the border box.
+
+            Note: This ensures that the <a>scroll snap margin</a> is always rectangular and axis-aligned to the <a>scroll container's</a> coordinate space.
+    </dl>
+
+    This property is a shorthand property that sets all of the 'scroll-snap-margin-*' longhands in one declaration.
+
+<h3 id="scroll-snap-align">Scroll Snap Alignment: the 'scroll-snap-align' property</h3>
 
-    The 'scroll-snap-align' property specifies how a scroll container's region specified by 'scroll-snap-padding' should align with descendent elements' scroll snap margin.  The two values specify the snapping behavior in the x and y axes, respectively.  If only one value is specified, the second value defaults to the same value.
+    The 'scroll-snap-align' property specifies how an element's scroll snap margin should align with its ancestor scroll container's snap alignment container.  The two values specify the snapping behavior in the x and y axes, respectively.  If only one value is specified, the second value defaults to the same value.
 
     Issue: Should this be x/y axes, or inline/block?  Starting with x/y axes for consistency with padding/area, otherwise a writing mode change would result in a axis mismatch (since padding is physical by default).
 
@@ -295,34 +323,6 @@ Issue: <b>This spec is currently undergoing major changes in line with the resol
             The scroll offset which aligns the center of this box's scroll snap margin with the center of its ancestor scroll container's region defined by 'scroll-snap-padding' in the specified axis is a <a>snap position</a> in that axis.
     </dl>
 
-<h2 id="properties-on-the-elements">Properties on the elements</h2>
-
-<h3 id="scroll-snap-margin">Scroll Snap Margin: the 'scroll-snap-margin' property</h3>
-
-    The 'scroll-snap-margin' property defines the <a>scroll snap margin</a> on elements within a <a>scroll container</a>, used in calculating <a>snap positions</a> for that scroll container.
-
-    <pre class="propdef">
-    Name: scroll-snap-margin
-    Value: <<length>>{1,4}
-    Initial: 0
-    Applies to: all elements
-    Inherited: no
-    Percentages: n/a
-    Media: interactive
-    Computed value: as specified, with lengths made absolute
-    Animatable: yes
-    </pre>
-
-    <dl dfn-type=value dfn-for="scroll-snap-margin">
-        <dt><dfn><<length>>{1,4}</dfn>
-        <dd>
-            Specifies the outset of the element's snap margin from the axis-aligned bounding box of the transformed border box, in the <a>scroll container's</a> coordinate space.  Outsets are applied to this bounding box, not the border box.
-
-            Note: This ensures that the <a>scroll snap margin</a> is always rectangular and axis-aligned to the <a>scroll container's</a> coordinate space.
-    </dl>
-
-    This property is a shorthand property that sets all of the 'scroll-snap-margin-*' longhands in one declaration.
-
 <h2 class=no-num id="acknowledgments">Acknowledgments</h2>
 
     Many thanks to lots of people for their proposals and recommendations, some of which are incorporated into this document.