[css-lists-3] Minor editorial cleanup in counters section.

Author: fantasai

css-lists-3/Overview.bs

@@ -664,25 +664,32 @@ Automatic Numbering With Counters</h2>
 	used, among other things, to automatically number list items in CSS.
 	Every element has a collection of zero or more counters,
 	which are inherited through the document tree in a way similar to inherited property values.
-	They are created and manipulated with the 'counter-increment', 'counter-set' and 'counter-reset' properties,
-	and retrieved with the ''counter()'' and ''counters()'' functions.
 	Counters have a name and creator element,
 	which identify the counter,
 	and an integer value per element.
+	They are created and manipulated with
+	the <dfn export>counter properties</dfn> 'counter-increment', 'counter-set' and 'counter-reset',
+	and used with the ''counter()'' and ''counters()'' [=functional notations=].
 
-	Resolving counter values on a given element is a multi-step process:
+	Resolving [=counter=] values on a given element is a multi-step process:
 
-	1. Existing counters are [=inherit counters|inherited=] from previous elements
-	2. New counters are [=instantiated=] ('counter-reset')
-	3. Counter values are incremented ('counter-increment')
-	4. Counter values are explicitly set ('counter-set')
-	5. Counter values are used (''counter()''/''counters()'')
+	1. Existing counters are [=inherit counters|inherited=] from previous elements.
+	2. New counters are [=instantiated=] ('counter-reset').
+	3. Counter values are incremented ('counter-increment').
+	4. Counter values are explicitly set ('counter-set').
+	5. Counter values are used (''counter()''/''counters()'').
+
+	UAs may have implementation-specific limits
+	on the maximum or minimum value of a counter.
+	If a counter reset, set, or increment
+	would push the value outside of that range,
+	the value must be clamped to that range.
 
 	ISSUE: This section is not fully synchronized with CSS2.
 	Please reference <a href="https://www.w3.org/TR/CSS2/generate.html#counters">Automatic Counters and Numbering in CSS Level 2</a>:
 	any conflicts or omissions here should be resolved in favor of the behavior specified in CSS2.
 
-<h3 id='counter-properties'>
+<h3 id='counter-reset'>
 Creating Counters: the 'counter-reset' property</h3>
 
 	<pre class="propdef">
@@ -699,7 +706,7 @@ Creating Counters: the 'counter-reset' property</h3>
 	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.
 
 	The 'counter-reset' property [=instantiates=] new [=counters=] on an element
-	and sets them to the specified counter values.
+	and sets them to the specified integer values.
 	Its values are defined as follows:
 
 	<dl dfn-type=value dfn-for=counter-reset>
@@ -712,17 +719,31 @@ Creating Counters: the 'counter-reset' property</h3>
 			[=Instantiates=] a counter of the given <<custom-ident>> <dfn>counter name</dfn>
 			with a starting value of the given <<integer>>,
 			defaulting to ''0''.
+	</dl>
 
-			If multiple instances of the same <<custom-ident>> occur in the property value,
-			only the last one is honored.
+	<div class='example' highlight=css>
+		Note that counter properties follow the [=cascading=] rules as normal.
+		Thus, due to cascading, the following style sheet:
 
-			UAs may have implementation-specific limits
-			on the maximum or minimum value of a counter.
-			Starting values outside this range
-			must be clamped to that range.
-	</dl>
+		<pre>
+			h1 { counter-reset: section -1 }
+			h1 { counter-reset: imagenum 99 }
+		</pre>
+
+		will only reset ''imagenum''.
+		To reset both counters,
+		they have to be specified together:
+
+		<pre>H1 { counter-reset: section -1 imagenum 99 }</pre>
+
+		The same principles apply to the 'counter-set' and 'counter-increment' properties.
+		See [[css-cascade-4]].
+	</div>
+
+	If multiple instances of the same <<custom-ident>> occur in the property value,
+	only the last one is honored.
 
-<h3 id='foo'>
+<h3 id='increment-set'>
 Manipulating Counter Values: the 'counter-increment' and 'counter-set' properties</h3>
 
 	<pre class='propdef'>
@@ -752,8 +773,8 @@ Manipulating Counter Values: the 'counter-increment' and 'counter-set' propertie
 	<p class=all-media>User Agents are expected to support this property on all media, including non-visual ones.
 
 	The 'counter-increment' and 'counter-set' properties
-	manipulate the value of existing counters.
-	They only instantiate new counters
+	manipulate the value of existing [=counters=].
+	They only [=instantiate=] new counters
 	if there is no counter of the given name on the element yet.
 	Their values are defined as follows:
 
@@ -775,11 +796,6 @@ Manipulating Counter Values: the 'counter-increment' and 'counter-set' propertie
 			the element [=instantiates=] a new counter of the given name
 			with a starting value of ''0''
 			before setting or incrementing its value.
-
-			UAs may have implementation-specific limits
-			on the maximum or minimum value of a counter.
-			If a set or increment would push the value outside of that range,
-			the value must be clamped to that range.
 	</dl>
 
 	<div class="example">
@@ -798,29 +814,11 @@ Manipulating Counter Values: the 'counter-increment' and 'counter-set' propertie
 		</pre>
 	</div>
 
-	<div class='example' highlight=css>
-		The counter properties follow the cascading rules as normal.
-		Thus, due to cascading, the following style sheet:
-
-		<pre>
-			h1 { counter-reset: section -1 }
-			h1 { counter-reset: imagenum 99 }
-		</pre>
-
-		will only reset ''imagenum''.
-		To reset both counters,
-		they have to be specified together:
-
-		<pre>H1 { counter-reset: section -1 imagenum 99 }</pre>
-
-		The same principles apply to the 'counter-set' and 'counter-increment' properties.
-	</div>
-
 <h3 id="creating-counters">
 Creating and Inheriting Counters</h3>
 
 	Each element or pseudo-element in a document has
-	a (possibly empty) set of counters associated to the element,
+	a (possibly empty) set of [=counters=] associated to the element,
 	either through inheritance from another element
 	or through instantiation on the element directly.
 	These counters are represented as a <dfn>CSS counters set</dfn>,