Skip to content

Commit dfe1c07

Browse files
committed
[docs] align ADR intro with the Compliance/Decision split; fix grammar
1 parent 98e1858 commit dfe1c07

1 file changed

Lines changed: 6 additions & 5 deletions

File tree

docs/decisions/17786-bidi-low-level-behavioral-contract.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,16 @@
88
The WebDriver BiDi specification is defined in CDDL. Any client implementation has a low-level layer
99
that turns typed calls into wire messages and wire messages back into typed objects. It sits above a
1010
transport (which sends commands and correlates responses) and below the orchestration and high-level
11-
API that program against it. *This record is about the low-level layer.*
11+
API that build on it. *This record is about the low-level layer.*
1212

13-
Because these behaviors follow from the specification rather than from taste, they are identical for any
14-
conforming implementation, in any language — so one contract can state them for every binding at once.
13+
These behaviors are observable at the wire boundary, so bindings diverge on them without a shared
14+
reference. One contract can state them for every binding at once — the same behavior in any language.
1515

1616
## Decision
1717

18-
**Any implementation of this layer must exhibit the behaviors below, each a consequence of conforming to
19-
the WebDriver BiDi specification.**
18+
**Any implementation of this layer must exhibit the behaviors below.** Some follow from conforming to the
19+
WebDriver BiDi specification; the rest are choices this record standardizes so bindings don't diverge —
20+
the next section marks which is which.
2021

2122
An implementation must exhibit them at runtime, not merely declare them in its types or schema. A
2223
statically-typed deserializer will fill a correctly-typed object from malformed input — most often a null

0 commit comments

Comments
 (0)