refactored the json-ld + schema parts

Author: micheldumontier

versions/3.0.0.md

@@ -1780,9 +1780,9 @@ This object MAY be extended with [Specification Extensions](#specificationExtens
 Field Name | Type | Description
 ---|:---:|---
 <a name="responseContent"></a>content | Map[`string`, [Media Type Object](#mediaTypeObject)] | **SHOULD** Use media type definitions listed at <a href="https://www.iana.org/assignments/media-types/media-types.xhtml">RFC6838</a>.
-<a name="responseProfile"></a>x-responseSchema| `URI` | Conformance to a particular schema/format.
-<a name="responseDataType"></a>x-responseValueType | [`responseValueType object`] | To specify the types of objects in the response. The responseValueType object consists of a required `x-valueType` that should provide URI values to the type of object, and an optional `x-path` to specify to ___location in the response for that valueType.
-<a name="x-JSONLDContext"></a>x-JSONLDContext | `URI` | JSON LD context.
+<a name="responseSchema"></a> | `URI` | Specify the json schema using a Reference Object, or use "x-uri" as an additional property in the schema field to point to an external ___location for an XML, RDF, etc schema.
+<a name="responseDataType"></a>x-responseValueType | [`responseValueType`] \| [Reference Object](#referenceObject)] | Specify the types of objects and relations in the response using either a reference to the JSON-LD context file or to a [Response Value Type](responseValueType). 
+
 
 ##### Response Object Examples
 
@@ -1906,19 +1906,33 @@ Response with no return value:
 ```yaml
 description: object created
 ```
-##### Response Object smartAPI Examples
+
+
+
+
+
+#### <a name="responseValueType"></a>Response Value Type [smartAPI extension]
+
+ that should provide URI values to the type of object, and an optional `x-path` to specify to ___location in the response for that valueType.
+
+
+##### smartAPI Fields
+
+Field Name | Type | Description
+---|:---:|---
+<a name="responseValueTypeObjectPath"></a>x-path | `string` | The path using dot notation to the element of interest. e.g. friend.name to follow the path from root object to the name attribute to the name field 
+<a name="responseValueTypeObjectValue"></a>x-valueType | `string` | The value type for the field. e.g. 
+
+##### Response Value Type Object smartAPI Example
+
 ```yaml
-responses:
-  - content:
-    - 'application/ld+json':
-      x-responseProfile: 'http://www.w3.org/ns/anno.jsonld'
-      x-responseValueType: 
-       - x-path: a.id
-         x-valueType: 'http://example.org/a.id'
-       - x-path: a.b.c.id
-         x-valueType: 'http://example.org/c.id'
+- x-path: ncbigene.id
+  x-valueType: http://identifiers.org/ncbigene:12345
+
 ```
 
+
+
 #### <a name="callbackObject"></a>Callback Object
 
 A map of possible out-of band callbacks related to the parent operation.