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

Commit 2aa6daa

Browse files
committed
Announce several things about process changes
This addresses some of the most commonly-heard questions and misconceptions about our recent process announcement.
1 parent b420f37 commit 2aa6daa

File tree

1 file changed

+10
-34
lines changed

1 file changed

+10
-34
lines changed

index.md

Lines changed: 10 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,16 @@ permalink: /
2020

2121
</div>
2222

23+
## Announcements and Feedback Solicitation: Specification Process
24+
25+
* The JSON Schema media types (`application/schema+json` and `application/schema-instance+json`) will be published as an [IETF RFC](https://datatracker.ietf.org/doc/draft-ietf-httpapi-rest-api-mediatypes/), which has already been adopted by the HTTP APIs working group.
26+
* As an [Incubation-status OpenJS Foundation project](https://openjsf.org/projects/#incubating), we continue to work through our governance [todo list](https://github.com/json-schema-org/community/issues/129) to move to either At-Large or Impact status.
27+
* The bulk of our specification will be published under a new process currently [under public discussion](https://github.com/orgs/json-schema-org/discussions/234). All are encouraged to provide feedback! Our goals with this process include:
28+
* In the next release, offer stability guarantees for long-stable aspects of JSON Schema.
29+
* Provide clarity regarding which other aspects are close to a stable form, and which are more experimental.
30+
* Publish our specifications in a way similar to OpenAPI and AsyncAPI, which are also part of the Linux Foundation (the larger umbrella under which the OpenJS Foundation exists).
31+
* We are working on finding the right path for Relative JSON Pointer to reach standardization in the near future. An IETF RFC currently remains the most likely path, although several details are still being worked out.
32+
2333
## What now?
2434

2535
Learn, Get help, Shape the Community, Chat, with the JSON Schema team and Community!
@@ -79,40 +89,6 @@ so we will usually refer to `2020-12` (without the word "draft") on this web sit
7989

8090
See the [Specification page](specification.html) for details about naming and numbering.
8191

82-
### The Path to Standardization
83-
84-
The JSON Schema project intends to shepherd all three draft series to either: RFC status, the equivalent within another standards body, and/or join a foundation and establish self publication rules.
85-
86-
<details markdown="1">
87-
<summary>Read more</summary>
88-
89-
Currently, we are continuing to improve our self-published Internet-Drafts. We are not actively pursuing joining a standards organisation.
90-
91-
We have a few contacts related to each potential path, but if you have experience with such things and would like to help, please still contact us!
92-
93-
In the meantime, publication of Internet-Draft documents can be tracked through the IETF:
94-
* [JSON Schema (core)](https://datatracker.ietf.org/doc/draft-bhutton-json-schema/)
95-
* [JSON Schema Validation](https://datatracker.ietf.org/doc/draft-bhutton-json-schema-validation/)
96-
* [Relative JSON Pointers](https://datatracker.ietf.org/doc/draft-bhutton-relative-json-pointer/)
97-
98-
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.
99-
</details>
100-
101-
### Use of the _draft_ designation
102-
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)).
103-
The use of this designation is under review but will continue until this review process completes to avoid changing the designation style multiple times.
104-
<details markdown="1">
105-
<summary>Read more</summary>
106-
107-
The JSON schema project recognizes, condones, and advocates for the use of the JSON schema standard in production.
108-
109-
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.
110-
111-
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.
112-
113-
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.
114-
</details>
115-
11692
## Quickstart
11793

11894
The JSON document being validated or described we call the *instance*, and the document containing the description is called the *schema*.

0 commit comments

Comments
 (0)