[css-cascade][css-syntax-3] Improve importance cross-linking.

Author: fantasai

css-cascade-3/Overview.bs

@@ -659,18 +659,20 @@ Cascade Order</h3>
 		<dt id='cascade-origin'>Origin and Importance
 		<dd>
 			The <a>origin</a> of a declaration is based on where it comes from
-			and its <a lt="important">importance</a> is whether or not it is declared ''!important'' (see below).
+			and its <a lt="important">importance</a> is
+			whether or not it is declared with ''!important''
+			(see [[#importance|below]]).
 			The precedence of the various <a>origins</a> is, in descending order:
 
 			<ol>
 				<li>Transition declarations [[!css-transitions-1]]
-				<li>Important user agent declarations
-				<li>Important user declarations
-				<li>Important author declarations
+				<li>[=Important=] user agent declarations
+				<li>[=Important=] user declarations
+				<li>[=Important=] author declarations
 				<li>Animation declarations [[!css-animations-1]]
-				<li>Normal author declarations
-				<li>Normal user declarations
-				<li>Normal user agent declarations
+				<li>[=Normal=] author declarations
+				<li>[=Normal=] user declarations
+				<li>[=Normal=] user agent declarations
 			</ol>
 
 			Declarations from <a>origins</a> earlier in this list win over declarations from later <a>origins</a>.
@@ -757,31 +759,32 @@ Important Declarations: the ''!important'' annotation</h3>
 	CSS attempts to create a balance of power between author and user style sheets.
 	By default, rules in an author's style sheet override those in a user's style sheet,
 	which override those in the user-agent's default style sheet.
-	To balance this, a declaration can be made <dfn export>important</dfn>,
+	To balance this, a declaration can be marked [=important=],
 	which increases its weight in the cascade and inverts the order of precedence.
 
-	A declaration is <a>important</a> if it has a <dfn export id='bang-important'>!important</dfn> annotation,
-	as defined by [[css-syntax-3]].
+	A declaration is <dfn export>important</dfn> if it has a ''!important'' annotation
+	as defined by [[css-syntax-3]],
 	i.e. if the last two (non-whitespace, non-comment) tokens
 	in its value are the delimiter token ''!'' followed by the identifier token ''important''.
+	All other declarations are <dfn>normal</dfn> (non-[=important=]).
 
 	<div class='example'>
 		<pre class='lang-css'>[hidden] { display: none !important; }</pre>
 	</div>
 
-	An <a>important</a> declaration takes precedence over a normal declaration.
-	Author and user style sheets may contain ''!important'' declarations,
-	with user ''!important'' declarations overriding author ''!important'' declarations.
+	An <a>important</a> declaration takes precedence over a [=normal=] declaration.
+	Author and user style sheets may contain [=important=] declarations,
+	with user [=important=] declarations overriding author [=important=] declarations.
 	This CSS feature improves accessibility of documents by giving users with special requirements
 	(large fonts, color combinations, etc.)
 	control over presentation.
 
-	Important declarations from all origins take precedence over animations.
+	[=Important=] declarations from all origins take precedence over animations.
 	This allows authors to override animated values in important cases.
 	(Animated values normally override all other rules.)
 	[[css-animations-1]]
 
-	User agent style sheets may also contain ''!important'' declarations.
+	User agent style sheets may also contain [=important=] declarations.
 	These override all author and user declarations.
 
 	<div class='example'>

css-cascade-4/Overview.bs

@@ -772,18 +772,20 @@ Cascade Order</h3>
 		<dt id='cascade-origin'>Origin and Importance
 		<dd>
 			The <a>origin</a> of a declaration is based on where it comes from
-			and its <a lt="important">importance</a> is whether or not it is declared ''!important'' (see below).
+			and its <a lt="important">importance</a> is
+			whether or not it is declared with ''!important''
+			(see [[#importance|below]]).
 			The precedence of the various <a>origins</a> is, in descending order:
 
 			<ol>
 				<li>Transition declarations [[!css-transitions-1]]
-				<li>Important user agent declarations
-				<li>Important user declarations
-				<li>Important author declarations
+				<li>[=Important=] user agent declarations
+				<li>[=Important=] user declarations
+				<li>[=Important=] author declarations
 				<li>Animation declarations [[!css-animations-1]]
-				<li>Normal author declarations
-				<li>Normal user declarations
-				<li>Normal user agent declarations
+				<li>[=Normal=] author declarations
+				<li>[=Normal=] user declarations
+				<li>[=Normal=] user agent declarations
 			</ol>
 
 			Declarations from <a>origins</a> earlier in this list win over declarations from later <a>origins</a>.
@@ -795,7 +797,7 @@ Cascade Order</h3>
 			such as the nested [=tree contexts=] of [=shadow trees=] in the [[!DOM]].
 			When comparing two declarations
 			that are sourced from different [=encapsulation contexts=],
-			then for normal rules
+			then for [=normal=] rules
 			the declaration from the outer context wins,
 			and for [=important=] rules
 			the declaration from the inner context wins.
@@ -809,15 +811,15 @@ Cascade Order</h3>
 
 			If the <a>scoping elements</a> of two declarations
 			have an ancestor/descendant relationship,
-			then for normal rules the declaration whose <a>scoping element</a> is the descendant wins,
-			and for important rules the declaration whose <a>scoping element</a> is the ancestor wins.
+			then for [=normal=] rules the declaration whose <a>scoping element</a> is the descendant wins,
+			and for [=important=] rules the declaration whose <a>scoping element</a> is the ancestor wins.
 
-			Note: In other words, for normal declarations the inner scope's declarations override,
+			Note: In other words, for [=normal=] declarations the inner scope's declarations override,
 			but for ''!important'' rules <em>outer</em> scope's override.
 
 			For the purpose of this step,
 			all unscoped declarations are considered to be <a>scoped</a> to the root element.
-			Normal declarations from style attributes
+			[=Normal=] declarations from style attributes
 			are considered to be <a>scoped</a> to the element with the attribute,
 			whereas important declarations from style attributes
 			are considered to be <a>scoped</a> to the root element.
@@ -908,31 +910,32 @@ Important Declarations: the ''!important'' annotation</h3>
 	CSS attempts to create a balance of power between author and user style sheets.
 	By default, rules in an author's style sheet override those in a user's style sheet,
 	which override those in the user-agent's default style sheet.
-	To balance this, a declaration can be made <dfn export>important</dfn>,
+	To balance this, a declaration can be marked [=important=],
 	which increases its weight in the cascade and inverts the order of precedence.
 
-	A declaration is <a>important</a> if it has a <dfn export id='bang-important'>!important</dfn> annotation,
-	as defined by [[css-syntax-3]].
+	A declaration is <dfn export>important</dfn> if it has a ''!important'' annotation
+	as defined by [[css-syntax-3]],
 	i.e. if the last two (non-whitespace, non-comment) tokens
 	in its value are the delimiter token ''!'' followed by the identifier token ''important''.
+	All other declarations are <dfn>normal</dfn> (non-[=important=]).
 
 	<div class='example'>
 		<pre class='lang-css'>[hidden] { display: none !important; }</pre>
 	</div>
 
-	An <a>important</a> declaration takes precedence over a normal declaration.
-	Author and user style sheets may contain ''!important'' declarations,
-	with user ''!important'' declarations overriding author ''!important'' declarations.
+	An <a>important</a> declaration takes precedence over a [=normal=] declaration.
+	Author and user style sheets may contain [=important=] declarations,
+	with user [=important=] declarations overriding author [=important=] declarations.
 	This CSS feature improves accessibility of documents by giving users with special requirements
 	(large fonts, color combinations, etc.)
 	control over presentation.
 
-	Important declarations from all origins take precedence over animations.
+	[=Important=] declarations from all origins take precedence over animations.
 	This allows authors to override animated values in important cases.
 	(Animated values normally override all other rules.)
 	[[css-animations-1]]
 
-	User agent style sheets may also contain ''!important'' declarations.
+	User agent style sheets may also contain [=important=] declarations.
 	These override all author and user declarations.
 
 	<div class='example'>

css-syntax-3/Overview.bs

@@ -3218,7 +3218,10 @@ Defining Block Contents: the <<declaration-list>>, <<rule-list>>, and <<styleshe
 	and with what specificity.
 	If they don't interact with the cascade,
 	properties containing <code>!important</code> are automatically invalid;
-	otherwise using <code>!important</code> is valid and has its usual effect on the cascade origin of the property.
+	otherwise using <code>!important</code> is valid
+	and causes the declaration to be [=important=]
+	for the purposes of the [=cascade=].
+	See [[!CSS-CASCADE-3]].
 
 	<div class='example'>
 		For example, the grammar for ''@font-face'' in the previous example must,