@@ -14,16 +14,16 @@ Related Issues:
1414
1515## Context and Problem Statement
1616
17- Currently JSON Schema follows the IETF Internet-Draft (I-D) process for spec
18- development and releases but aren 't associated with IETF in any way. Our
17+ Currently JSON Schema loosely follows the IETF Internet-Draft (I-D) process for
18+ spec development and releases but isn 't associated with IETF in any way. Our
1919perceived involvement with IETF causes confusion and misunderstanding within our
20- community in the cases were our needs and the realities of our situation deviate
21- from the IETF process.
20+ community in the cases were our practices and the realities of our situation
21+ deviate from the typical IETF I-D process.
2222
2323## Decision Drivers
2424
2525* IETF's draft versioning system doesn't work for JSON Schema and we stopped
26- using it to version our releases a while ago. We now use a date based version
26+ using it to version our releases a while ago. We now use date based versioning
2727 and even have more than one draft submission per release (the initial release
2828 and the patch release).
2929* The IETF process is optimized for working on a draft until it's done and then
@@ -52,31 +52,36 @@ from the IETF process.
5252
53531 . Continue to submit I-Ds, while using our customized process with no intention
5454 of pursing standards track RFC status.
55- 2 . Get JSON Schema to a stable place and pursue a standards track RFC with the
56- IETF.
57- 3 . Decouple from IETF completely and come up with our own governance model.
55+ 2 . Go all-in with IETF and pursue a standards track RFC with the IETF.
56+ 3 . Join W3C and pursue a standards track with them using their process.
57+ 4 . Decouple completely from any standards organization and come up with our own
58+ specification development lifecycle (SDLC) model inspired by well established
59+ projects with an SDLC that more closely meets or needs.
5860
5961## Decision Outcome
6062
61- Our decision is to go with Option 3 and decouple from IETF completely and come
62- up with our own governance model. The idea of having to come up with our own
63- governance model is daunting, but when the alternatives are to continue to abuse
64- the I-D process or to conform to the IETF process that doesn't fit our needs,
65- going our own way seems the best option.
63+ Our decision is to go with Option 4 and decouple from standards organizations
64+ that don't fit our needs. We don't currently have a plan for what to replace
65+ IETF with. We are currently investigating how other established projects do
66+ their SDLC and will likely choose one to emulate and adapt to our needs.
67+ Although we don't have a replacement solution in place yet, we are confident
68+ that continuing to abuse the IETF I-D process or conforming to a standards
69+ organization process that doesn't fit our needs is not the way to go.
6670
6771### Positive Consequences
6872
6973* Decoupling from IETF allows us to distance ourselves from the assumptions that
7074 people make about JSON Schema because they assume it works like a typical I-D.
71- * Decoupling from IETF allows us to customize our governance model to what works
72- best for JSON Schema.
75+ * Decoupling from IETF allows us to customize our SDLC model to what works best
76+ for JSON Schema.
7377
7478### Negative Consequences
7579
76- * Choosing our own governance model means we aren't associated with a recognized
77- standard body which could reduce to credibility of JSON Schema in the eyes of
78- some.
79- * If we don't go the standardization route with IETF, we lose access to their
80- expert review process.
81- * Defining our own process will be a lot of work and none of use have expertise
82- in defining such a process.
80+ * Not being associated with a recognized standards organization such as IETF,
81+ W3C, or IEEE reduces the credibility of JSON Schema in the eyes of some.
82+ * If we don't go the standardization route with IETF or W3C, we lose access to
83+ their expert review process.
84+ * Defining our own SLDC process will be a lot of work and none of us have
85+ expertise in defining such a process. However, we can take inspiration from
86+ existing well established projects and we would have the freedom to update our
87+ process as we learn what works and what doesn't.
0 commit comments