Skip to content

Commit 7792c15

Browse files
authored
Merge pull request #3920 from handrews/more-editorial-304
Minor editiorial and link target fixes (3.0.4)
2 parents 936f8a5 + 6a72329 commit 7792c15

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

versions/3.0.4.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1197,14 +1197,14 @@ label | false | . | .blue | .blue,black,brown | .R,100,G,200,B,150
11971197
label | true | . | .blue | .blue.black.brown | .R=100.G=200.B=150
11981198
simple | false | _empty_ | blue | blue,black,brown | R,100,G,200,B,150
11991199
simple | true | _empty_ | blue | blue,black,brown | R=100,G=200,B=150
1200-
form | false | ?color= | ?color=blue | ?color=blue,black,brown | ?color=R,100,G,200,B,150
1201-
form | true | ?color= | ?color=blue | ?color=blue&color=black&color=brown | ?R=100&G=200&B=150
1202-
spaceDelimited | false | _n/a_ | _n/a_ | ?color=blue%20black%20brown | ?color=R%20100%20G%20200%20B%20150
1200+
form | false | <span style="white-space: nowrap;">?color=</span> | <span style="white-space: nowrap;">?color=blue</span> | <span style="white-space: nowrap;">?color=blue,black,brown</span> | <span style="white-space: nowrap;">?color=R,100,G,200,B,150</span>
1201+
form | true | <span style="white-space: nowrap;">?color=</span> | <span style="white-space: nowrap;">?color=blue</span> | <span style="white-space: nowrap;">?color=blue&color=black&color=brown</span> | <span style="white-space: nowrap;">?R=100&G=200&B=150</span>
1202+
spaceDelimited</span> | false | _n/a_ | _n/a_ | <span style="white-space: nowrap;">?color=blue%20black%20brown</span> | <span style="white-space: nowrap;">?color=R%20100%20G%20200%20B%20150</span>
12031203
spaceDelimited | true | _n/a_ | _n/a_ | _n/a_ | _n/a_
1204-
pipeDelimited | false | _n/a_ | _n/a_ | ?color=blue%7Cblack%7Cbrown | ?color=R%7C100%7CG%7C200%7CB%7C150
1204+
pipeDelimited | false | _n/a_ | _n/a_ | <span style="white-space: nowrap;">?color=blue%7Cblack%7Cbrown</span> | <span style="white-space: nowrap;">?color=R%7C100%7CG%7C200%7CB%7C150</span>
12051205
pipeDelimited | true | _n/a_ | _n/a_ | _n/a_ | _n/a_
12061206
deepObject | false | _n/a_ | _n/a_ | _n/a_ | _n/a_
1207-
deepObject | true | _n/a_ | _n/a_ | _n/a_ | ?color%5BR%5D=100&color%5BG%5D=200&color%5BB%5D=150
1207+
deepObject | true | _n/a_ | _n/a_ | _n/a_ | <span style="white-space: nowrap;">?color%5BR%5D=100&color%5BG%5D=200&color%5BB%5D=150</span>
12081208

12091209
##### Parameter Object Examples
12101210

@@ -3917,7 +3917,7 @@ The extensions properties are implemented as patterned fields that are always pr
39173917

39183918
Field Pattern | Type | Description
39193919
---|:---:|---
3920-
<a name="infoExtensions"></a>^x- | Any | Allows extensions to the OpenAPI Schema. The field name MUST begin with `x-`, for example, `x-internal-id`. The value can be any valid JSON format value (`null`, a primitive, an array or an object.)
3920+
<a name="infoExtensions"></a>^x- | Any | Allows extensions to the OpenAPI Schema. The field name MUST begin with `x-`, for example, `x-internal-id`. The value can be any valid JSON value (`null`, a primitive, an array or an object.)
39213921

39223922
The OpenAPI Initiative maintains several [extension registries](https://spec.openapis.org/registry/index.html), including registries for [individual extension keywords](https://spec.openapis.org/registry/extension/) and [extension keyword namespaces](https://spec.openapis.org/registry/namespace/).
39233923

@@ -4149,7 +4149,7 @@ parameters:
41494149
We can't combine the `?` and `+` RFC6570 prefixes, and there's no way with RFC6570 to replace the `,` separator with a space character.
41504150
So we need to restructure the data to fit a manually constructed URI Template that passes all of the pieces through the right sort of expansion.
41514151

4152-
Here is one such template, using a made-up convention of `words.0` for the first entry in the words value, `words.1` for the second.
4152+
Here is one such template, using a made-up convention of `words.0` for the first entry in the words value, `words.1` for the second, and `words.2` for the third:
41534153

41544154
```urlencoded
41554155
?a={+a}&b={+b}&c={+c}&words={words.0} {words.1} {words.2}
@@ -4162,7 +4162,7 @@ We'll also need to pre-process the values for `formulas` because while `/` and m
41624162

41634163
Setting `allowReserved: true` does _not_ make reserved characters that are not allowed in URIs allowed, it just allows them to be _passed through expansion unchanged._
41644164
Therefore, any tooling still needs to percent-encode those characters because reserved expansion will not do it, but it _will_ leave the percent-encoded triples unchanged.
4165-
See also [Appendix E](#to indicate name hierarchy in substructures) for further guidance on percent-encoding and form media types, including guidance on handling the delimiter characters for `spaceDelimited`, `pipeDelimited`, and `deepObject` in parameter names and values.
4165+
See also [Appendix E](#percentEncodingAndFormMediaTypes) for further guidance on percent-encoding and form media types, including guidance on handling the delimiter characters for `spaceDelimited`, `pipeDelimited`, and `deepObject` in parameter names and values.
41664166

41674167
So here is our data structure that arranges the names and values to suit the template above, where values for `formulas` have `[]#&=+` pre-percent encoded (although only `+` appears in this example):
41684168

0 commit comments

Comments
 (0)