From 2b2c537a62e6150ef421a68562bfa55fa593a289 Mon Sep 17 00:00:00 2001 From: jasonh-n-austin Date: Fri, 5 Jun 2015 11:01:06 -0500 Subject: [PATCH 1/2] Examples for relative/separate schema in Reference Object --- versions/2.0.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/versions/2.0.md b/versions/2.0.md index 66a36f2e67..e2c82c9c10 100755 --- a/versions/2.0.md +++ b/versions/2.0.md @@ -1126,6 +1126,27 @@ Field Name | Type | Description $ref: '#/definitions/Pet' ``` +##### Relative Schema File Example +```js +{ + "$ref": "Pet.json" +} +``` + +```yaml +$ref: 'Pet.yaml' + +##### Relative Files With Embedded Schema Example +```js +{ + "$ref": "definitions.json#/Pet" +} +``` + +```yaml +$ref: 'definitions.yaml#/Pet' + + #### Schema Object The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is based on the [JSON Schema Specification Draft 4](http://json-schema.org/) and uses a predefined subset of it. On top of this subset, there are extensions provided by this specification to allow for more complete documentation. From 39e71ab60456e581527a9172015afdc19ef7944f Mon Sep 17 00:00:00 2001 From: jasonh-n-austin Date: Fri, 5 Jun 2015 12:45:54 -0500 Subject: [PATCH 2/2] Fixed missing code sample close(s) --- versions/2.0.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/versions/2.0.md b/versions/2.0.md index e2c82c9c10..1b5571b5c4 100755 --- a/versions/2.0.md +++ b/versions/2.0.md @@ -1135,6 +1135,7 @@ $ref: '#/definitions/Pet' ```yaml $ref: 'Pet.yaml' +``` ##### Relative Files With Embedded Schema Example ```js @@ -1145,7 +1146,7 @@ $ref: 'Pet.yaml' ```yaml $ref: 'definitions.yaml#/Pet' - +``` #### Schema Object