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

Commit 24c9a1d

Browse files
committed
Add rationale for continued use of draft designation
Also change "qualifier" to "designation", and fix grammar in third paragraph.
1 parent 14e53de commit 24c9a1d

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

index.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,17 +67,18 @@ In the meantime, publication of Internet-Draft documents can be tracked through
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.
6868
</details>
6969

70-
### Use of the _draft_ qualifier
70+
### Use of the _draft_ designation
7171

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.
72+
Releases of the JSON schema specification and meta schemas use the _draft_ designation primarily for historical reasons stemming from the relationship of this specification to IETF ([explained here](https://json-schema.org/specification-links.html#understanding-draft-names-and-numbers)).
73+
The use of this designation is under review but will continue until this review process completes to avoid changing the designation style multiple times.
7374

7475
The JSON schema project recognizes, condones and advocates for the use of the JSON schema standard in production.
7576

76-
Each release of the JSON schema specification 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+
Each release of the JSON schema specification is treated as a production release by the JSON schema project. All changes in each new release are made judiciously, with great care, thorough review and careful consideration of how the changes will impact existing users and implementations of the JSON schema specification.
7778

7879
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.
7980

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.
81+
When the _draft_ designation is dropped 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.
8182

8283
## Quickstart
8384

0 commit comments

Comments
 (0)