Skip to content

Commit 1d81cac

Browse files
committed
Remove commented text, simplify Accept-Post
Minor tidying and removal of an unnecessary reference.
1 parent 065263a commit 1d81cac

File tree

1 file changed

+4
-16
lines changed

1 file changed

+4
-16
lines changed

jsonschema-hyperschema.xml

Lines changed: 4 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,6 @@
1515
<!ENTITY I-D.nottingham-rfc5988bis SYSTEM "https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.draft-nottingham-rfc5988bis-08.xml">
1616
<!ENTITY I-D.luff-relative-json-pointer SYSTEM "https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.draft-luff-relative-json-pointer-00.xml">
1717
<!ENTITY I-D.reschke-http-jfv SYSTEM "https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.draft-reschke-http-jfv-06.xml">
18-
<!ENTITY ldp SYSTEM "https://xml2rfc.tools.ietf.org/public/rfc/bibxml4/reference.W3C.REC-ldp-20150226.xml">
1918
]>
2019
<?rfc toc="yes"?>
2120
<?rfc symrefs="yes"?>
@@ -1257,7 +1256,6 @@ for varname in templateData:
12571256
&rfc6573;
12581257
&rfc7231;
12591258
&I-D.nottingham-rfc5988bis;
1260-
&ldp;
12611259
</references>
12621260
<section title="JSON Hyper-Schema and HTTP" anchor="HTTP">
12631261
<t>
@@ -1300,8 +1298,8 @@ for varname in templateData:
13001298
<t>
13011299
The relationship between a resource's representation and HTTP requests and
13021300
responses is determined by <xref target="RFC7231">RFC 7231, section 4.3.1 -
1303-
"GET", section 4.3.4 "PUT", and section 3.1.4.2,
1304-
"Content-Location"</xref>. In particular, "targetSchema" suggests what a
1301+
"GET", section 4.3.4 "PUT", and section 3.1.4.2, "Content-Location"</xref>.
1302+
In particular, "targetSchema" suggests what a
13051303
client can expect for the response to an HTTP GET or any response for which
13061304
the "Content-Location" header is equal to the request URI, and what a client
13071305
should send if it replaces the resource in an HTTP PUT request.
@@ -1318,25 +1316,15 @@ for varname in templateData:
13181316
</t>
13191317
<t>
13201318
HTTP POST requests are determined by the "submissionSchema" and
1321-
"submissionMediaType" fields. Alternatively, the "Accept-Post" header has
1322-
been defined and registered by the
1323-
<xref target="W3C.REC-ldp-20150226">Linked Data Platform</xref>, and MAY be
1319+
"submissionMediaType" fields. Additionally, the "Accept-Post" header
1320+
can be used to specify the necessary media type, and MAY be
13241321
advertised via the "targetHints" field.
13251322
<cref>
13261323
What happens if both are used? Also, "submissionSchema" is a MUST
13271324
to support, while "targetHints" are at most a SHOULD. But forbidding
13281325
the use of "Accept-Post" in "targetHints" seems incorrect.
13291326
</cref>
13301327
</t>
1331-
<!-- targetMediaType and "Accept"
1332-
<t>
1333-
If this property's value is specified, and the link's target is to be obtained
1334-
using any protocol that supports the HTTP/1.1 "Accept" header
1335-
<xref target="RFC7231">RFC 7231, section 5.3.2</xref>, then user agents MAY use
1336-
the value of this property to aid in the assembly of that header when making the
1337-
request to the server.
1338-
</t>
1339-
-->
13401328
</section>
13411329
<section title='Optimizing HTTP discoverability with "targetHints"'>
13421330
<t>

0 commit comments

Comments
 (0)