Skip to content

Commit fd4f83c

Browse files
jdesrosiersRelequestual
authored andcommitted
ADR decouple from IETF draft 2
1 parent 12cbd86 commit fd4f83c

File tree

1 file changed

+27
-22
lines changed

1 file changed

+27
-22
lines changed

adr/2022-08-decouple-from-ietf.md

Lines changed: 27 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -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
1919
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.
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

5353
1. 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

Comments
 (0)