Skip to content

Commit ce1364b

Browse files
committed
adjust page indexes; fix section numbers
1 parent e4ea439 commit ce1364b

File tree

4 files changed

+13
-13
lines changed

4 files changed

+13
-13
lines changed

.jekyll-metadata

3.56 KB
Binary file not shown.

_docs/schema/vocabs/data-2023.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: A Vocabulary for Accessing Data Stored in JSON (2023)
44
bookmark: data (2023)
55
permalink: /schema/vocabs/data-2023/
66
icon: fas fa-tag
7-
order: "1.8.4"
7+
order: "01.8.2"
88
---
99
## 1. Purpose {#purpose}
1010

@@ -29,17 +29,17 @@ The meta-schema which validates keyword usage for this vocabulary can be found a
2929

3030
## 3. Definitions {#definitions}
3131

32-
### 3.1 Formed Schema {#formed-schema}
32+
### 3.1. Formed Schema {#formed-schema}
3333

3434
The schema object created as a result of dereferencing all of the values in either the `data` or `optionalData` keywords as described in section 4.1. That is, each keyword produces an independent formed schema.
3535

36-
### 3.2 Host Schema {#host-schema}
36+
### 3.2. Host Schema {#host-schema}
3737

3838
The schema object which contains either the `data` or `optionalData` keyword. The processing rules that govern this schema also govern the formed schema, as specified by section 4.2.
3939

4040
## 4. The `data` and `optionalData` Keywords {#data-keyword}
4141

42-
### 4.1 Syntax and Semantics {#semantics}
42+
### 4.1. Syntax and Semantics {#semantics}
4343

4444
The values of `data` and `optionalData` must be objects. The keys of these objects are interpreted as JSON Schema keywords, and the values MUST be one of
4545

@@ -59,7 +59,7 @@ The values of `data` and `optionalData` must be objects. The keys of these obje
5959

6060
The validation and annotation results of `data` and `optionalData` are those of the formed schemas. More detail regarding output can be found in section 4.4.
6161

62-
### 4.2 Contextual Behavior {#behavior}
62+
### 4.2. Contextual Behavior {#behavior}
6363

6464
`data` and `optionalData` MUST be processed contextually in the same manner as the host schema. Specifically,
6565

@@ -71,7 +71,7 @@ Implementations SHOULD validate that the resolved data forms a valid schema agai
7171
> It is not necessary for an implementation to validate the formed schema using the meta-schema. Other mechanisms internal to the implementation (such as deserialization) may suffice to perform this task.
7272
{: .prompt-info }
7373

74-
### 4.3 Resolving data {#resolution}
74+
### 4.3. Resolving data {#resolution}
7575

7676
The string values within `data` and `optionalData` are dereferenced in different ways depending on the format of the value.
7777

@@ -85,29 +85,29 @@ Because JSON Pointers and Relative JSON Pointers are syntactically valid IRIs, t
8585

8686
For each successfully resolved reference, the full value at the specified location MUST be returned.
8787

88-
#### 4.3.1 Reference Resolution Failure {#resolution-failure}
88+
#### 4.3.1. Reference Resolution Failure {#resolution-failure}
8989

9090
The `data` and `optionalData` keywords differ only in their behavior when resolving a reference fails.
9191

9292
For `data`, if a reference cannot be resolved, or if a resolved value is not valid for the associated keyword, evaluation MUST halt. Implementations SHOULD use native features of their language to report the failure as appropriate. Implementations MAY continue to attempt to resolve other references so that multiple resolution failures can be reported together, however further schema evaluation MUST NOT continue.
9393

9494
For `optionalData`, if a reference cannot be resolved, or if a resolved value is not valid for the associated keyword, that keyword MUST be ignored and excluded from the resulting formed schema. As a consequence, evaluation MUST proceed as if that keyword is absent.
9595

96-
#### 4.3.2 External Data Access {#external}
96+
#### 4.3.2. External Data Access {#external}
9797

9898
Implementations SHOULD provide a means to pre-load and cache any external references prior to evaluation but MAY be configured to fetch external documents at evaluation time. Documents fetched from IRIs which contain a JSON Pointer fragment MUST be interpreted using a media type, such as `application/schema-instance+json`, that allows resolution of such fragments.
9999

100100
Users should be aware that fetching data from external locations may carry certain security risks not covered by this document.
101101

102-
### 4.4 Output {#output}
102+
### 4.4. Output {#output}
103103

104104
The evaluation output of the formed schema is reported into the overall schema output incorporating "data" or "optionalData" into the evaluation path as appropriate and following on with additional pointer segments as navigable within the formed schema.
105105

106106
Annotation results of the formed schema are retained as per the host schema so that they can be processed by other keywords such as `unevaluatedItems` and `unevaluatedProperties`.
107107

108108
## 5. Examples {#examples}
109109

110-
### 5.1 `data` Example {#data-example}
110+
### 5.1. `data` Example {#data-example}
111111

112112
The following defines a schema to validate an object instance with a `bar` property that must contain an numeric value less than or equal to the value in the instance's `foo` property.
113113

@@ -144,7 +144,7 @@ The following shows how a change in the `foo` property, or its absence, can affe
144144
{ "bar": 20 }
145145
```
146146

147-
### 5.2 `optionalData` Example {#optionalData-example}
147+
### 5.2. `optionalData` Example {#optionalData-example}
148148

149149
In the following schema, `bar` is required to be less than `foo`, however `foo` itself is not required.
150150

_docs/schema/vocabs/unique-keys.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: A Vocabulary for Identifying Uniqueness of Array Items
44
bookmark: uniqueKeys
55
permalink: /schema/vocabs/uniquekeys/
66
icon: fas fa-tag
7-
order: "01.8.2"
7+
order: "01.8.3"
88
---
99

1010
> This vocabulary will soon be deprecated and replaced by the more general [Array Extensions vocabulary](/schema/vocabs/array-ext).

_docs/schema/vocabs/vocabs-array-ext.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: A Vocabulary for Extended Validation of Arrays (WIP)
44
bookmark: Array Extensions
55
permalink: /schema/vocabs/array-ext/
66
icon: fas fa-tag
7-
order: "01.8.3"
7+
order: "01.8.4"
88
---
99

1010
> This vocabulary is a work in progress. It is intended to deprecate and replace the existing [`uniqueKeys` vocabulary](/schema/vocabs/uniquekeys) by adding some more array-centric functionality. Comments, questions, and ideas are welcome as issues in the [main `json-everything` repository](https://github.com/gregsdennis/json-everything).

0 commit comments

Comments
 (0)