Skip to content

Commit d511830

Browse files
remove unnecessary use of "content"
Appendix D no longer talks about percent-encoding of headers, as the specification is now clear that percent-encoding of headers is never done (with the exception of the use of style:form in Cookie headers).
1 parent b5641f2 commit d511830

1 file changed

Lines changed: 8 additions & 16 deletions

File tree

src/oas.md

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2000,8 +2000,6 @@ multipart/mixed:
20002000
As described in [[?RFC2557]], a set of resources making up a web page can be sent in a `multipart/related` payload, preserving links from the `text/html` document to subsidiary resources such as scripts, style sheets, and images by defining a `Content-Location` header for each page.
20012001
The first part is used as the root resource (unless using `Content-ID`, which RFC2557 advises against and is forbidden in this example), so we use `prefixItems` and `prefixEncoding` to define that it must be an HTML resource, and then allow any of several different types of resources in any order to follow.
20022002

2003-
The `Content-Location` header is defined using `content: {text/plain: {...}}` to avoid percent-encoding its URI value; see [Appendix D](#appendix-d-serializing-headers-and-cookies) for further details.
2004-
20052003
```yaml
20062004
components:
20072005
headers:
@@ -2010,12 +2008,10 @@ components:
20102008
schema: false
20112009
RFC2557ContentLocation:
20122010
required: true
2013-
content:
2014-
text/plain:
2015-
schema:
2016-
$comment: Use a full URI (not a relative reference)
2017-
type: string
2018-
format: uri
2011+
schema:
2012+
$comment: Use a full URI (not a relative reference)
2013+
type: string
2014+
format: uri
20192015
requestBodies:
20202016
RFC2557:
20212017
content:
@@ -2060,8 +2056,6 @@ multipart/mixed:
20602056

20612057
For `multipart/byteranges` [[RFC9110]] [Section 14.6](https://www.rfc-editor.org/rfc/rfc9110.html#section-14.6), a `Content-Range` header is required:
20622058

2063-
See [Appendix D](#appendix-d-serializing-headers-and-cookies) for an explanation of why `content: {text/plain: {...}}` is used to describe the header value.
2064-
20652059
```yaml
20662060
multipart/byteranges:
20672061
itemSchema:
@@ -2071,12 +2065,10 @@ multipart/byteranges:
20712065
headers:
20722066
Content-Range:
20732067
required: true
2074-
content:
2075-
text/plain:
2076-
schema:
2077-
# The `pattern` regular expression that would
2078-
# be included in practice is omitted for simplicity
2079-
type: string
2068+
schema:
2069+
# The `pattern` regular expression that would
2070+
# be included in practice is omitted for simplicity
2071+
type: string
20802072
```
20812073
20822074
##### Example: Nested `multipart/mixed`

0 commit comments

Comments
 (0)