@@ -229,16 +229,16 @@ Registering Custom Highlights</h3>
229
229
The <dfn>custom highlight name</dfn> assigned to a [=custom highlight=] when it is [=registered=]
230
230
is used to identify the highlight during styling (see [[#styling-highlights]] ).
231
231
232
- Note: When registering a [=custom highlight=] , authors are recommended to use a
232
+ Note: When registering a [=custom highlight=] , authors are advised to use a
233
233
[=custom highlight name=] that is a valid CSS [=identifier=] . Using a name that is not a valid
234
234
identifier can make the highlight hard, and in some cases impossible, to style via CSS.
235
235
236
236
Note: It is possible to [=register=] a [=custom highlight=] with more than one [=custom highlight name=] .
237
237
However, using more than one name to style a highlight will assign the highlight multiple different sets
238
238
of styles, without a way to control the stacking order of conflicting styles within these sets
239
- during [[#painting|painting]] . This may be limiting for authors and may cause confusing painting behavior
239
+ during [[#painting|painting]] . This could be limiting for authors and could cause confusing painting behavior
240
240
(see the <a href="#styling-problems-with-multiple-names-per-highlight">example</a> below for more context). Therefore,
241
- <b> it is recommended that authors only use one name per highlight during styling</b> .
241
+ <b> authors are advised to only use one name per highlight during styling</b> .
242
242
<div class=example id=styling-problems-with-multiple-names-per-highlight>
243
243
<xmp highlight=html>
244
244
<style>
@@ -261,7 +261,7 @@ Registering Custom Highlights</h3>
261
261
</script>
262
262
</xmp>
263
263
In the example above, the same [=custom highlight=] object is [=registered=] under the names 'foo' and 'bar' .
264
- Since each of the [=style rules=] target the same highlight and have the same [=specificity=] , authors may
264
+ Since each of the [=style rules=] target the same highlight and have the same [=specificity=] , authors might
265
265
expect the last rule to win in cascading order and the highlighted content to be green. However, each highlight
266
266
name gets an independent set of highlight styles, and the highlight will be painted once per name. In
267
267
this case, because 'foo' was registered before 'bar' , the highlight will be first painted with 'foo' 's
0 commit comments