@@ -472,11 +472,11 @@ Highlight types</h4>
472472 A custom highlight will have a default type of {{HighlightType/highlight}}
473473 if its {{Highlight/type}} attribute has not been explicitly set.
474474
475- Note: Authors should set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/spelling-error}}
475+ Note: Authors are advised to set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/spelling-error}}
476476 when that [=custom highlight=] is being used to emphasize misspelled content.
477- Authors should set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/grammar-error}}
477+ Authors are advised to set a [=custom highlight=] 's {{Highlight/type}} to {{HighlightType/grammar-error}}
478478 when that [=custom highlight=] is being used to emphasize content that is grammatically incorrect.
479- For all other use cases {{Highlight/type}} should be left as {{HighlightType/highlight}} .
479+ For all other use cases {{Highlight/type}} is best left as {{HighlightType/highlight}} .
480480
481481 UAs should make [=custom highlight=] s available to assistive technologies.
482482 When exposing a highlight using a given platform accessibility API,
@@ -486,20 +486,20 @@ Highlight types</h4>
486486
487487 Note: For example,
488488 if a platform accessibility API has the capability to express spelling errors and grammar errors specifically,
489- then UAs should use these capabilities to convey the semantics for highlights
489+ then UAs is expected to use these capabilities to convey the semantics for highlights
490490 with {{HighlightType/spelling-error}} and {{HighlightType/spelling-error}} .
491491 If an accessibility API only has the capability to express spelling errors,
492- then UAs should convey both highlights with {{HighlightType/spelling-error}}
492+ then UAs would be expected to convey both highlights with {{HighlightType/spelling-error}}
493493 and with {{HighlightType/grammar-error}} using spelling error semantics.
494494 If an accessibility API has support for expressing neither spelling errors nor grammar errors,
495- then UAs should expose all highlights as generic {{HighlightType/highlight}} regardless of their actual {{Highlight/type}} .
495+ then UAs would expose all highlights as generic {{HighlightType/highlight}} regardless of their actual {{Highlight/type}} .
496496
497497 Note: This initial set of types was chosen
498498 because they are expected to be popular use cases for Highlight API
499499 and there is some existing support for expressing their semantics in platform accessibility APIs today.
500500 Accessibility APIs currently don't have any way to express the specific semantics
501501 of other expected Highlight API use cases.
502- More types may be added to {{HighlightType}}
502+ More types could later be added to {{HighlightType}}
503503 as accessibility APIs gain support for expressing additional popular use cases of Highlight API.
504504
505505<h2 id=responding-to-changes>
0 commit comments