Skip to content

Commit 8f83782

Browse files
committed
Cleanup Hyper-Schema from left-over examples/wordings about "media"
And move the sentence about "multimedia documents" back to Validation document where it still makes sense.
1 parent c23e0b6 commit 8f83782

File tree

2 files changed

+7
-36
lines changed

2 files changed

+7
-36
lines changed

jsonschema-hyperschema.xml

Lines changed: 3 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -121,8 +121,6 @@
121121
<t>
122122
This document describes how JSON Schema can be used to define hyperlinks on instance
123123
data.
124-
It also defines how to provide additional information required to interpret JSON
125-
data as rich multimedia documents.
126124
</t>
127125
<t>
128126
As with all JSON Schema keywords, all the keywords described in the "Schema
@@ -131,8 +129,7 @@
131129
</t>
132130
<figure>
133131
<preamble>
134-
Here is an example JSON Schema defining hyperlinks, and providing a multimedia
135-
interpretation for the "imgData" property:
132+
Here is an example JSON Schema defining hyperlinks:
136133
</preamble>
137134
<artwork>
138135
<![CDATA[
@@ -151,14 +148,6 @@
151148
},
152149
"authorId": {
153150
"type": "integer"
154-
},
155-
"imgData": {
156-
"title": "Article Illustration (thumbnail)",
157-
"type": "string",
158-
"media": {
159-
"binaryEncoding": "base64",
160-
"type": "image/png"
161-
}
162151
}
163152
},
164153
"required" : ["id", "title", "authorId"],
@@ -176,11 +165,8 @@
176165
]]>
177166
</artwork>
178167
<postamble>
179-
This example schema defines the properties of the instance. For the "imgData"
180-
property, it specifies that that it should be base64-decoded and the resulting
181-
binary data treated as a PNG image.
182-
It also defines link relations for the instance, with URIs incorporating values
183-
from the instance.
168+
This example schema defines the properties of the instance as well as link
169+
relations for the instance, with URIs incorporating values from the instance.
184170
<cref>
185171
"id" probably should not normally be a required keyword, since new instances
186172
will have an unknown "id" property until is it assigned by the server.
@@ -190,25 +176,6 @@
190176
</postamble>
191177
</figure>
192178

193-
<figure>
194-
<preamble>
195-
An example of a JSON instance described by the above schema might be:
196-
</preamble>
197-
<artwork>
198-
<![CDATA[
199-
{
200-
"id": 15,
201-
"title": "Example data",
202-
"authorId": 105,
203-
"imgData": "iVBORw...kJggg=="
204-
}
205-
]]>
206-
</artwork>
207-
<postamble>
208-
The base-64 data has been abbreviated for readability.
209-
</postamble>
210-
</figure>
211-
212179
<section title="Interaction with validation">
213180
<t>
214181
Hyper-schema keywords can be applied when the instance is valid against

jsonschema-validation.xml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -909,6 +909,10 @@
909909
non-JSON data encoded in a JSON string.
910910
They describe the type of content and how it is encoded.
911911
</t>
912+
<t>
913+
These properties provide additional information required to interpret JSON data
914+
as rich multimedia documents.
915+
</t>
912916
</section>
913917

914918
<section title="contentEncoding">

0 commit comments

Comments
 (0)