From 7a081e5d604bd7f894f3040a28c48bfb1bc4d7ba Mon Sep 17 00:00:00 2001 From: Valerii Petryniak <44531564+valerii15298@users.noreply.github.com> Date: Thu, 25 Dec 2025 01:13:48 +0200 Subject: [PATCH 1/6] Fix typo in querystring formats section --- src/oas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/oas.md b/src/oas.md index da5374a3c3..f685dc8c8a 100644 --- a/src/oas.md +++ b/src/oas.md @@ -935,7 +935,7 @@ The following table shows serialized examples, as would be shown with the `seria #### Extending Support for Querystring Formats -Many frameworks define query string syntax for complex values, such as appending array indices to parameter names or indicating multiple levels of of nested objects, which go well beyond the capabilities of the `deepObject` style. +Many frameworks define query string syntax for complex values, such as appending array indices to parameter names or indicating multiple levels of nested objects, which go well beyond the capabilities of the `deepObject` style. As these are not standards, and often contradict each other, the OAS does not attempt to support them directly. Two avenues are available for supporting such formats with `in: "querystring"`: From 438a0b3b9902e43e31ea17e5915f7dc5c70ecf6c Mon Sep 17 00:00:00 2001 From: Valerii Petryniak <44531564+valerii15298@users.noreply.github.com> Date: Thu, 25 Dec 2025 01:35:00 +0200 Subject: [PATCH 2/6] Update section header from 'serializedExample' to 'serializedValue' --- src/oas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/oas.md b/src/oas.md index f685dc8c8a..d1b6803717 100644 --- a/src/oas.md +++ b/src/oas.md @@ -2383,7 +2383,7 @@ The `serializedValue` and `externalValue` fields both MUST show the serialized f For Media Type Objects, this is a document of the appropriate media type, with any Encoding Object effects applied. For Parameter and Header Objects using `schema` and `style` rather than a Media Type Object, see [Style Examples](#style-examples) for what constitutes a serialized value. -##### Criteria for `serializedExample` +##### Criteria for `serializedValue` A serialization can be represented as a valid Unicode string in `serializedValue` if any of the following are true of the serialization: From 7a4a94572914ace2050a5e90047f2626c4df8771 Mon Sep 17 00:00:00 2001 From: Valerii Petryniak <44531564+valerii15298@users.noreply.github.com> Date: Thu, 25 Dec 2025 01:39:32 +0200 Subject: [PATCH 3/6] Rename serializeValue to serializedValue --- src/oas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/oas.md b/src/oas.md index d1b6803717..ca87db3a4e 100644 --- a/src/oas.md +++ b/src/oas.md @@ -1070,7 +1070,7 @@ examples: dataValue: page: 4 pageSize: 50 - serializeValue: page=4&pageSize=50 + serializedValue: page=4&pageSize=50 ``` A complex parameter using `content` to define serialization, with multiple levels and types of examples shown to make the example usage options clear — note that `dataValue` is the same at both levels and does not need to be shown in both places in normal usage, but `serializedValue` is different: From e26db51c9dc6bf17cda41f37f7d1f3a3349430e6 Mon Sep 17 00:00:00 2001 From: Valerii Petryniak <44531564+valerii15298@users.noreply.github.com> Date: Thu, 25 Dec 2025 01:41:47 +0200 Subject: [PATCH 4/6] Fix typo in HTTP Set-Cookie example --- src/oas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/oas.md b/src/oas.md index ca87db3a4e..f41736d734 100644 --- a/src/oas.md +++ b/src/oas.md @@ -2858,7 +2858,7 @@ components: In an HTTP message, the serialized example would look like: ```http -Set-Cookie: lang=en-US; Expires=Wed, 09 Jun 2021 10:18:14 GM +Set-Cookie: lang=en-US; Expires=Wed, 09 Jun 2021 10:18:14 GMT Set-Cookie: foo=bar; Expires=Wed, 09 Jun 2021 10:18:14 GMT Set-Cookie: urlSafeData=Hello%2C%20world%21 ``` From f67aecea0677e9a914202bddd961244a67b2b76e Mon Sep 17 00:00:00 2001 From: Valerii Petryniak <44531564+valerii15298@users.noreply.github.com> Date: Thu, 25 Dec 2025 01:44:59 +0200 Subject: [PATCH 5/6] Remove unused span artifact --- src/oas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/oas.md b/src/oas.md index f41736d734..d6549b3767 100644 --- a/src/oas.md +++ b/src/oas.md @@ -925,7 +925,7 @@ The following table shows serialized examples, as would be shown with the `seria | simple | true | _empty_ | blue | blue,black,brown | R=100,G=200,B=150 | | form | false | color= | color=blue | color=blue,black,brown | color=R,100,G,200,B,150 | | form | true | color= | color=blue | color=blue&color=black&color=brown | R=100&G=200&B=150 | -| spaceDelimited | false | _n/a_ | _n/a_ | color=blue%20black%20brown | color=R%20100%20G%20200%20B%20150 | +| spaceDelimited | false | _n/a_ | _n/a_ | color=blue%20black%20brown | color=R%20100%20G%20200%20B%20150 | | spaceDelimited | true | _n/a_ | _n/a_ | _n/a_ | _n/a_ | | pipeDelimited | false | _n/a_ | _n/a_ | color=blue%7Cblack%7Cbrown | color=R%7C100%7CG%7C200%7CB%7C150 | | pipeDelimited | true | _n/a_ | _n/a_ | _n/a_ | _n/a_ | From 73234f9f8c3f43474eea52065401f581b430e6f7 Mon Sep 17 00:00:00 2001 From: Valerii Petryniak <44531564+valerii15298@users.noreply.github.com> Date: Thu, 25 Dec 2025 01:51:23 +0200 Subject: [PATCH 6/6] Fix yaml formatting --- src/oas.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/oas.md b/src/oas.md index d6549b3767..86aebf95c4 100644 --- a/src/oas.md +++ b/src/oas.md @@ -4449,8 +4449,7 @@ application/xml: - Some text - unit: cubits value: 42 - null - ] + - null externalValue: ./examples/OneTwoThree.xml ```