From 43c52a88045ac9ea4c18f6396df04aa1e7938793 Mon Sep 17 00:00:00 2001 From: Ivan Martinez-Ortiz Date: Tue, 2 Aug 2022 20:08:52 +0200 Subject: [PATCH] Clarify current version of the used JSONSchema specification Background information provided at #256 --- xapi-profiles-about.md | 2 +- xapi-profiles-structure.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/xapi-profiles-about.md b/xapi-profiles-about.md index 71c3fc0..fbf3bf2 100644 --- a/xapi-profiles-about.md +++ b/xapi-profiles-about.md @@ -239,7 +239,7 @@ even if there no requirement in a given area. **JSON**: [JavaScript Object Notation](http://www.json.org). A simple way to represent data structures for computers that humans don't have too hard a time writing or reading. The way Profiles are represented in this specification. -**JSON Schema**: [JSON Schema](http://json-schema.org) are a way to describe and constrain the form of JSON documents. +**JSON Schema**: [JSON Schema](http://json-schema.org) are a way to describe and constrain the form of JSON documents. This specification adheres to [Draft-07](https://json-schema.org/specification-links.html#draft-7) version of the JSON Schema specification. **JSON-LD**: [JSON-LD](https://json-ld.org) turns JSON into Linked Data, making it easy to use with Linked Data tools and integrate with other datasets. diff --git a/xapi-profiles-structure.md b/xapi-profiles-structure.md index 5ef4399..91275c8 100644 --- a/xapi-profiles-structure.md +++ b/xapi-profiles-structure.md @@ -272,7 +272,7 @@ Property | Type | Description | Required `schema` | IRI | the IRI for accessing a JSON Schema for this extension. The JSON Schema can be used to constrain the extension to a single type. | Optional `inlineSchema` | Object | An alternate way to include a JSON Schema, as a string. | Optional -Profiles MUST use at most one of `schema` and `inlineSchema` for Extensions. +Profiles MUST use at most one of `schema` and `inlineSchema` for Extensions. JSON Schema expressions SHOULD adhere to the [Draft-07](https://json-schema.org/specification-links.html#draft-7) version of the JSON Schema specification. Statements including extensions defined in a Profile MUST: * only use a ContextExtension in context @@ -325,7 +325,7 @@ Property | Type | Description | Required `schema` | IRI | the IRI for accessing a JSON Schema for this document resource. | Optional `inlineSchema` | String | An alternate way to include a JSON Schema, as a string. | Optional -Profiles MUST use at most one of `schema` and `inlineSchema` for Document Resources +Profiles MUST use at most one of `schema` and `inlineSchema` for Document Resources. JSON Schema expressions SHOULD adhere to the [Draft-07](https://json-schema.org/specification-links.html#draft-7) version of the JSON Schema specification. Learning Record Store Clients sending Document Resources * MUST use the `id` as the `stateId` or `profileId` (as appropriate) when interacting with the corresponding resource.