@@ -14,16 +14,16 @@ Related Issues:
14
14
15
15
## Context and Problem Statement
16
16
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
19
19
perceived 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.
22
22
23
23
## Decision Drivers
24
24
25
25
* 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
27
27
and even have more than one draft submission per release (the initial release
28
28
and the patch release).
29
29
* The IETF process is optimized for working on a draft until it's done and then
@@ -52,31 +52,36 @@ from the IETF process.
52
52
53
53
1 . Continue to submit I-Ds, while using our customized process with no intention
54
54
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.
58
60
59
61
## Decision Outcome
60
62
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.
66
70
67
71
### Positive Consequences
68
72
69
73
* Decoupling from IETF allows us to distance ourselves from the assumptions that
70
74
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.
73
77
74
78
### Negative Consequences
75
79
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