Skip to content
This repository was archived by the owner on Nov 2, 2023. It is now read-only.

Commit a7ae96b

Browse files
committed
Clarify the meaning of the draft qualifier
1 parent a9d6492 commit a7ae96b

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

index.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,10 +65,19 @@ In the meantime, publication of Internet-Draft documents can be tracked through
6565
* [Relative JSON Pointers](https://datatracker.ietf.org/doc/draft-bhutton-relative-json-pointer/)
6666

6767
Internet-Drafts expire after six months, so our goal is to publish often enough to always have a set of unexpired drafts available. There may be brief gaps as we wrap up each draft and finalize the text.
68+
</details>
6869

69-
The intention, particularly for vocabularies such as validation which have been widely implemented, is to remain as compatible as possible from draft to draft. However, these are still drafts, and given a clear enough need validated with the user community, major changes can occur.
70+
### Use of the _draft_ qualifier
7071

71-
</details>
72+
Releases of the JSON schema specification and meta schemas are qualified as _draft_ primarily for historical reasons stemming from the relationship of this specification to IETF.
73+
74+
The JSON schema project recognizes, condones and advocates for the use of the JSON schema standard in production.
75+
76+
Each release of the JSON schema is treated as a production release by the JSON schema project. All changes in each new release are made judiciously, with great care and thorough review with careful consideration of how the changes will impact existing users and implementations of the JSON schema specification.
77+
78+
Similarly to most specifications, the JSON schema specification will continue to evolve, and not all releases will be backwards compatible. The intention, particularly for vocabularies such as validation which have been widely implemented, is to remain as compatible as possible from release to release. However, major changes can still occur given a clear enough need validated with the user community.
79+
80+
At some point, the draft qualifier will be dropped, and this may indicate that the frequency of releases and amount of changes in each release will decrease, but it won't indicate that no new releases will be made, or that all future releases will be backwards compatible.
7281

7382
## Quickstart
7483

0 commit comments

Comments
 (0)