Skip to content

Commit 91e8577

Browse files
committed
Fewer commas, formatting, ABNF indentation
1 parent ddbab4a commit 91e8577

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

versions/3.0.4.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2285,7 +2285,7 @@ The presence of a link does not guarantee the caller's ability to successfully i
22852285

22862286
Unlike _dynamic_ links (i.e. links provided **in** the response payload), the OAS linking mechanism does not require link information in the runtime response.
22872287

2288-
For computing links, and providing instructions to execute them, a [runtime expression](#runtime-expressions) is used for accessing values in an operation and using them as parameters while invoking the linked operation.
2288+
For computing links and providing instructions to execute them, a [runtime expression](#runtime-expressions) is used for accessing values in an operation and using them as parameters while invoking the linked operation.
22892289

22902290
##### Fixed Fields
22912291

@@ -2372,10 +2372,10 @@ links:
23722372
```
23732373
23742374
Clients follow all links at their discretion.
2375-
Neither permissions, nor the capability to make a successful call to that link, is guaranteed
2375+
Neither permissions nor the capability to make a successful call to that link is guaranteed
23762376
solely by the existence of a relationship.
23772377
2378-
##### OperationRef Examples
2378+
##### `operationRef` Examples
23792379

23802380
As references to `operationId` MAY NOT be possible (the `operationId` is an optional
23812381
field in an [Operation Object](#operation-object)), references MAY also be made through a relative `operationRef`:
@@ -2400,8 +2400,8 @@ links:
24002400
username: $response.body#/username
24012401
```
24022402

2403-
Note that in the use of `operationRef`, the _escaped forward-slash_ is necessary when
2404-
using JSON Pointer, and it is necessary to URL-encode `{` and `}` as `%7B` and `%7D`, respectively when using JSON Pointer as URI fragments.
2403+
Note that in the use of `operationRef` the _escaped forward-slash_ is necessary when
2404+
using JSON Pointer, and it is necessary to URL-encode `{` and `}` as `%7B` and `%7D`, respectively, when using JSON Pointer as URI fragments.
24052405

24062406
##### Runtime Expressions
24072407

@@ -2411,22 +2411,22 @@ This mechanism is used by [Link Objects](#link-object) and [Callback Objects](#c
24112411
The runtime expression is defined by the following [ABNF](https://tools.ietf.org/html/rfc5234) syntax
24122412

24132413
```abnf
2414-
expression = ( "$url" / "$method" / "$statusCode" / "$request." source / "$response." source )
2415-
source = ( header-reference / query-reference / path-reference / body-reference )
2414+
expression = "$url" / "$method" / "$statusCode" / "$request." source / "$response." source
2415+
source = header-reference / query-reference / path-reference / body-reference
24162416
header-reference = "header." token
2417-
query-reference = "query." name
2418-
path-reference = "path." name
2419-
body-reference = "body" ["#" json-pointer ]
2417+
query-reference = "query." name
2418+
path-reference = "path." name
2419+
body-reference = "body" ["#" json-pointer ]
24202420
json-pointer = *( "/" reference-token )
24212421
reference-token = *( unescaped / escaped )
24222422
unescaped = %x00-2E / %x30-7D / %x7F-10FFFF
2423-
; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
2423+
; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
24242424
escaped = "~" ( "0" / "1" )
2425-
; representing '~' and '/', respectively
2425+
; representing '~' and '/', respectively
24262426
name = *( CHAR )
24272427
token = 1*tchar
2428-
tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." /
2429-
"^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
2428+
tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "."
2429+
/ "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
24302430
```
24312431

24322432
Here, `json-pointer` is taken from [RFC6901](https://tools.ietf.org/html/rfc6901), `char` from [RFC7159](https://tools.ietf.org/html/rfc7159#section-7) and `token` from [RFC7230](https://tools.ietf.org/html/rfc7230#section-3.2.6).

0 commit comments

Comments
 (0)