Skip to content

Commit 5b6be31

Browse files
authored
Lowercase RFC 2119 keywords (#1490)
Per https://wicg.github.io/attribution-reporting-api/#w3c-conventions "these words do not appear in all uppercase letters in this specification".
1 parent 51b136f commit 5b6be31

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

index.bs

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -426,7 +426,7 @@ a [=set=] of [=strings=] |allowedKeys|:
426426
value |value|, and the parameters |params| to |entries|.
427427
1. Return a [=structured header/dictionary=] containing |entries|.
428428

429-
Note: The user agent MAY "[=structured header/define new structured fields|grease=]" the
429+
Note: The user agent may "[=structured header/define new structured fields|grease=]" the
430430
dictionary structured headers according to the preceding algorithm to help ensure that recipients
431431
use a proper structured header parser, rather than naive string equality or
432432
`contains` operations, which makes it easier to introduce backwards-compatible
@@ -1339,7 +1339,7 @@ However attribution data is inherently cross-site, and operations on storage wou
13391339
An <dfn>internal ID</dfn> is an integer.
13401340

13411341
To <dfn>get the next internal ID</dfn>, return an [=internal ID=] strictly
1342-
greater than any previously returned by this algorithm. The user agent MAY reset
1342+
greater than any previously returned by this algorithm. The user agent may reset
13431343
this sequence when no [=attribution cache=] entry contains an [=internal ID=].
13441344

13451345
# Constants # {#constants}
@@ -2156,7 +2156,7 @@ To <dfn export>process an attribution eligible response</dfn> given a [=suitable
21562156
|contextOrigin|, an [=eligibility=] |eligibility|, a [=boolean=] |fenced|,
21572157
and a [=response=] |response|:
21582158

2159-
1. The user-agent MAY ignore the response; if so, return.
2159+
1. The user-agent may ignore the response; if so, return.
21602160

21612161
Note: The user-agent may prevent attribution for a number of reasons, such as user opt-out. In these
21622162
cases, it is preferred to abort the API flow at response time rather than at request time so this
@@ -4658,7 +4658,7 @@ Issue: Specify this in terms of <a href="https://html.spec.whatwg.org/multipage/
46584658

46594659
# Report delivery # {#report-delivery}
46604660

4661-
The user agent MUST periodically run [=queue reports for delivery=] on the
4661+
The user agent must periodically run [=queue reports for delivery=] on the
46624662
[=event-level report cache=] and [=aggregatable attribution report cache=].
46634663

46644664
To <dfn>queue reports for delivery</dfn> given a [=set=] of
@@ -5040,7 +5040,7 @@ To <dfn>attempt to deliver a report</dfn> given an [=attribution report=] |repor
50405040

50415041
1. [=Assert=]: Neither the [=event-level report cache=] nor the
50425042
[=aggregatable attribution report cache=] [=set/contains=] |report|.
5043-
1. The user-agent MAY ignore the report; if so, return.
5043+
1. The user-agent may ignore the report; if so, return.
50445044
1. Let |url| be the result of executing [=generate an attribution report URL=] on |report|.
50455045
1. Let |data| be the result of executing [=serialize an attribution report=] on |report|.
50465046
1. If |data| is an error, return.
@@ -5049,15 +5049,15 @@ To <dfn>attempt to deliver a report</dfn> given an [=attribution report=] |repor
50495049

50505050
Issue(220): This fetch should use a network partition key for an opaque origin.
50515051

5052-
A user agent MAY retry this algorithm in the event that there was an error.
5052+
A user agent may retry this algorithm in the event that there was an error.
50535053
To prevent the report recipient from learning additional information about
50545054
whether a user is online, retries might be limited in number and subject to random delays.
50555055

50565056
<h3 id="issue-debug-report-request">Issuing a debug report request</h3>
50575057

50585058
To <dfn>attempt to deliver a debug report</dfn> given an [=attribution report=] |report|:
50595059

5060-
1. The user-agent MAY ignore the report; if so, return.
5060+
1. The user-agent may ignore the report; if so, return.
50615061
1. Let |url| be the result of executing [=generate an attribution report URL=] on |report| with
50625062
[=generate an attribution report URL/isDebugReport=] set to true.
50635063
1. Let |data| be the result of executing [=serialize an attribution report=] on |report|.
@@ -5069,7 +5069,7 @@ To <dfn>attempt to deliver a debug report</dfn> given an [=attribution report=]
50695069

50705070
To <dfn>attempt to deliver a verbose debug report</dfn> given a [=verbose debug report=] |report|:
50715071

5072-
1. The user-agent MAY ignore the report; if so, return.
5072+
1. The user-agent may ignore the report; if so, return.
50735073
1. Let |url| be the result of executing [=generate a verbose debug report URL=] on |report|.
50745074
1. Let |data| be the result of executing [=serialize a verbose debug report=] on |report|.
50755075
1. Let |request| be the result of executing [=create a report request=] on |url| and |data|.
@@ -5079,15 +5079,15 @@ To <dfn>attempt to deliver a verbose debug report</dfn> given a [=verbose debug
50795079

50805080
To <dfn>attempt to deliver an aggregatable debug report</dfn> given an [=aggregatable debug report=] |report|:
50815081

5082-
1. The user-agent MAY ignore the report; if so, return.
5082+
1. The user-agent may ignore the report; if so, return.
50835083
1. Let |url| be the result of executing [=generate an aggregatable debug report URL=] on |report|.
50845084
1. Let |data| be the result of executing [=serialize an aggregatable debug report=] on |report|.
50855085
1. Let |request| be the result of executing [=create a report request=] on |url| and |data|.
50865086
1. [=Fetch=] |request|.
50875087

50885088
Issue(220): This fetch should use a network partition key for an opaque origin.
50895089

5090-
A user agent MAY retry this algorithm in the event that there was an error.
5090+
A user agent may retry this algorithm in the event that there was an error.
50915091

50925092
# Cross App and Web Algorithms # {#cross-app-and-web}
50935093

@@ -5310,7 +5310,7 @@ context.
53105310
## Clearing site data ## {#clearing-site-data}
53115311

53125312
The [=attribution caches=] contain data about a user's web activity. As such,
5313-
the user agent MAY expose controls that allow the user to delete data from them.
5313+
the user agent may expose controls that allow the user to delete data from them.
53145314

53155315
## Cross-site information disclosure ## {#cross-site-information-disclosure}
53165316

0 commit comments

Comments
 (0)