Skip to content

Commit 7cf5fcc

Browse files
andreasttAutomatedTester
authored andcommitted
get rid of legacy RFC2119 style
The WebDriver specification is normative in its descriptions, and no longer depends on RFC2119, and in particular its capitalised styling of MUST, SHOULD, RECOMMENDED, MAY, et al. This patch largely retains the words, but de-capitalises them. In a few cases it rewrites the sentence to make better sense in English.
1 parent ab32fb3 commit 7cf5fcc

File tree

1 file changed

+14
-18
lines changed

1 file changed

+14
-18
lines changed

index.html

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -418,7 +418,7 @@ <h3>Processing model</h3>
418418
and how it is established are out of scope.
419419

420420
<p>After such a <a>connection</a> has been established,
421-
a <a>remote end</a> MUST run the following steps:</p>
421+
a <a>remote end</a> must run the following steps:</p>
422422

423423
<ol>
424424
<li><p><a>Read bytes</a> from the <a>connection</a> until a
@@ -1379,8 +1379,8 @@ <h2>Capabilities</h2>
13791379
to describe the full feature set for a <a>session</a>.
13801380

13811381
<p>The following <dfn>table of standard capabilities</dfn>
1382-
enumerates the capabilities each implementation MUST support.
1383-
An implementation MAY define additional <a>extension capabilities</a>.
1382+
enumerates the capabilities each implementation must support.
1383+
An implementation may define additional <a>extension capabilities</a>.
13841384

13851385
<aside class="example">
13861386
<p>As an example, Mozilla could elect to hide new features behind capabilities
@@ -2190,17 +2190,16 @@ <h3 id=new-session><dfn data-lt="new sessions|creating a new session">New Sessio
21902190
If the creation fails, a <a>session not created</a> <a>error</a> is returned.
21912191

21922192
<p>If the <a>remote end</a> is an <a>intermediary node</a>,
2193-
it MAY use the result of the <a>capabilities processing</a> algorithm
2193+
it may use the result of the <a>capabilities processing</a> algorithm
21942194
to route the <a>new session</a> request to the appropriate <a>endpoint node</a>.
2195-
An <a>intermediary node</a> MAY also define <a>extension capabilities</a>
2196-
to assist in this process, however, these specific capabilities MUST NOT be
2197-
forwarded to the <a>endpoint node</a>.
2195+
An <a>intermediary node</a> is free to define <a>extension capabilities</a>
2196+
to assist in this process, however, these specific capabilities
2197+
must not be forwarded to the <a>endpoint node</a>.
21982198

2199-
<p>If the <a>intermediary node</a> requires additional information
2200-
unrelated to user agent features,
2201-
it is RECOMMENDED that this information be passed as top-level parameters,
2199+
<p>If the <a>intermediary node</a> requires additional information unrelated to user agent features,
2200+
it is recommended that this information be passed as top-level parameters,
22022201
and not as part of the requested <a>capabilities</a>.
2203-
An <a>intermediary node</a> MUST forward custom,
2202+
An <a>intermediary node</a> must forward custom,
22042203
top-level parameters (i.e. non-<a>capabilities</a>) to subsequent <a>remote end</a> nodes.
22052204

22062205
<aside class=example>
@@ -2218,9 +2217,8 @@ <h3 id=new-session><dfn data-lt="new sessions|creating a new session">New Sessio
22182217
}</pre>
22192218

22202219
<p>However, because an <a>intermediary node</a> cannot forward
2221-
<a>extension capabilities</a> specific to that implementation to
2222-
an <a>endpoint node</a>, the following is also permitted by this
2223-
specification:
2220+
<a>extension capabilities</a> specific to that implementation to an <a>endpoint node</a>,
2221+
the following is also permitted by this specification:
22242222

22252223
<pre>{
22262224
"capabilities": {
@@ -2236,15 +2234,13 @@ <h3 id=new-session><dfn data-lt="new sessions|creating a new session">New Sessio
22362234
}
22372235
}</pre>
22382236

2239-
<p>Once all <a data-lt="merging capabilities">capabilities are
2240-
merged</a> from this example, an <a>endpoint node</a> would receive
2241-
<a>New Session</a> capabilities identical to:
2237+
<p>Once all <a data-lt="merging capabilities">capabilities are merged</a> from this example,
2238+
an <a>endpoint node</a> would receive <a>New Session</a> capabilities identical to:
22422239

22432240
<pre>[
22442241
{"browserName": "chrome", "platformName": "linux"},
22452242
{"browserName": "edge", "platformName": "linux"}
22462243
]</pre>
2247-
22482244
</aside>
22492245

22502246
<p>The <a>remote end steps</a> are:

0 commit comments

Comments
 (0)