Skip to content

Commit 162ca2e

Browse files
committed
[css-highlight] Avoid use of RFC2119 keywords in non normative text
1 parent dea0c10 commit 162ca2e

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

css-highlight-api-1/Overview.bs

+7-7
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)