Skip to content

Commit 599449e

Browse files
committed
pushing to back up
1 parent 4412afc commit 599449e

File tree

2 files changed

+27
-6
lines changed

2 files changed

+27
-6
lines changed

specs/jsonschema-core.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -427,6 +427,12 @@ keywords MUST NOT begin with this prefix.
427427
Implementations MUST refuse to evaluate schemas which contain keywords which
428428
they do not know how to process or explicitly choose not to process.
429429

430+
## Specification Versioning and Compatibility
431+
432+
This specification is versioned by two values: iteration and release year.
433+
434+
A schema written to conform with the requirements of a given version (iteration and release year) is compatible with specifications published with the same iteration value and either the same or greater release year value. Thus, JSON Schema provides a guarantee of compatibility for future releases within an iteration.
435+
430436
## Keyword Behaviors {#keyword-behaviors}
431437

432438
JSON Schema keywords may exhibit one or more behaviors. This specification

specs/jsonschema-validation.md

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -103,16 +103,31 @@ specification.
103103
## Meta-Schema {#meta-schema}
104104

105105
The current IRI for the default JSON Schema dialect meta-schema is
106-
`https://json-schema.org/draft/next/schema`. For schema author convenience, this
107-
meta-schema describes a dialect consisting of all keywords defined in this
106+
`https://json-schema.org/1/2025`. This IRI encodes the specifications iteration
107+
value and release year. Because all schemas written to conform to a given
108+
version are guaranteed to be compatible with later releases within the same
109+
iteration, the meta-schema IRI `https://json-schema.org/1` is also recognized to
110+
represent the latest release within the indicated iteration.
111+
112+
The meta-schema describes a dialect consisting of all keywords defined in this
108113
specification and the JSON Schema Core specification. Certain keywords specify
109114
some functionality which is optional to support and is explained in detail in
110115
the relevant sections.
111116

112-
Updated meta-schema IRIs MAY be published between specification drafts in order
113-
to correct errors. Implementations SHOULD consider IRIs dated after this
114-
specification draft and before the next to indicate the same syntax and
115-
semantics as those listed here.
117+
Where the meta-schema conflicts with either this specification or the JSON
118+
Schema Core specification, the specifications take precedence, and the
119+
meta-schema is to be considered in error. The meta-schema may be occasionally
120+
updated to correct any such errors.
121+
122+
Although the IRI for the default JSON Schema dialect meta-schema is also a valid
123+
URL, implementations MUST NOT assume that a document is provided at this
124+
location. Rather than performing a network request to retrieve the meta-schema,
125+
implementations SHOULD include a copy of the meta-schema and MAY encode it as
126+
required by the language or framework used by the implementation.
127+
128+
## Specification Versioning
129+
130+
The meta-schema IRI format encodes two values that will assist users in determining compatibiility between releases of the JSON Schema specifications.
116131

117132
## Keywords for Structural Validation
118133

0 commit comments

Comments
 (0)