Skip to content

Commit 4275281

Browse files
committed
pushing to back up
1 parent d642ed2 commit 4275281

File tree

2 files changed

+27
-6
lines changed

2 files changed

+27
-6
lines changed

specs/jsonschema-core.md

+6
Original file line numberDiff line numberDiff line change
@@ -416,6 +416,12 @@ keywords MUST NOT begin with this prefix.
416416
Implementations MUST refuse to evaluate schemas which contain keywords which
417417
they do not know how to process or explicitly choose not to process.
418418

419+
## Specification Versioning and Compatibility
420+
421+
This specification is versioned by two values: iteration and release year.
422+
423+
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.
424+
419425
## Keyword Behaviors
420426

421427
JSON Schema keywords fall into several general behavior categories. Assertions

specs/jsonschema-validation.md

+21-6
Original file line numberDiff line numberDiff line change
@@ -88,16 +88,31 @@ specification.
8888
## Meta-Schema {#meta-schema}
8989

9090
The current IRI for the default JSON Schema dialect meta-schema is
91-
`https://json-schema.org/draft/next/schema`. For schema author convenience, this
92-
meta-schema describes a dialect consisting of all keywords defined in this
91+
`https://json-schema.org/1/2025`. This IRI encodes the specifications iteration
92+
value and release year. Because all schemas written to conform to a given
93+
version are guaranteed to be compatible with later releases within the same
94+
iteration, the meta-schema IRI `https://json-schema.org/1` is also recognized to
95+
represent the latest release within the indicated iteration.
96+
97+
The meta-schema describes a dialect consisting of all keywords defined in this
9398
specification and the JSON Schema Core specification. Certain keywords specify
9499
some functionality which is optional to support and is explained in detail in
95100
the relevant sections.
96101

97-
Updated meta-schema IRIs MAY be published between specification drafts in order
98-
to correct errors. Implementations SHOULD consider IRIs dated after this
99-
specification draft and before the next to indicate the same syntax and
100-
semantics as those listed here.
102+
Where the meta-schema conflicts with either this specification or the JSON
103+
Schema Core specification, the specifications take precedence, and the
104+
meta-schema is to be considered in error. The meta-schema may be occasionally
105+
updated to correct any such errors.
106+
107+
Although the IRI for the default JSON Schema dialect meta-schema is also a valid
108+
URL, implementations MUST NOT assume that a document is provided at this
109+
location. Rather than performing a network request to retrieve the meta-schema,
110+
implementations SHOULD include a copy of the meta-schema and MAY encode it as
111+
required by the language or framework used by the implementation.
112+
113+
## Specification Versioning
114+
115+
The meta-schema IRI format encodes two values that will assist users in determining compatibiility between releases of the JSON Schema specifications.
101116

102117
## Keywords for Structural Validation
103118

0 commit comments

Comments
 (0)