Skip to content

Commit c6424fe

Browse files
committed
added notes based on PR feedback
1 parent 554e694 commit c6424fe

File tree

1 file changed

+9
-3
lines changed

1 file changed

+9
-3
lines changed

PROCESS.md

+9-3
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ Some behaviors within JSON Schema may be explicitly or implicitly undefined by t
1515

1616
A defined behavior is one that is fully and unambiguously defined by the specifications.
1717

18+
An undefined behavior is said to have an "indeterminate" validation result since implementations may resolve the behavior in different ways.
19+
1820
### Stability and Breaking Changes
1921

2022
Stability is defined using the level of compatibility between sequential releases. If all schemas which are written to one release produce the same defined behavior under the following release, then those releases are compatible, and the specification is said to be stable between them.
@@ -30,7 +32,7 @@ For reference, this table shows the validation results of a hypothetical schema
3032
<td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Next➡️<br>⬇️Current</td>
3133
<th width="150" align="center">pass</th>
3234
<th width="150" align="center">fail</th>
33-
<th width="150" align="center">indeterminant</th>
35+
<th width="150" align="center">indeterminate</th>
3436
</tr>
3537
<tr>
3638
<th align="center">pass</th>
@@ -45,7 +47,7 @@ For reference, this table shows the validation results of a hypothetical schema
4547
<td align="center">❌</td>
4648
</tr>
4749
<tr>
48-
<th align="center">indeterminant</th>
50+
<th align="center">indeterminate</th>
4951
<td align="center">✅</td>
5052
<td align="center">✅</td>
5153
<td align="center">✅</td>
@@ -130,6 +132,8 @@ During this stage, members of the Core Team will implement private prototypes of
130132
- Is the idea merely a shortcut for some existing functionality (syntactic sugar), or does it solve a previously unsolvable problem?
131133
- What is the expected complexity for implementing the feature?
132134

135+
At least two (2) Core Team members must have implemented prototypes before the concept can continue to the formal proposal process.
136+
133137
### Proposal
134138

135139
Once a rough consensus for the idea has been reached, a formal proposal will be written, separate from the specification, with the goal of precisely defining specification changes.
@@ -155,9 +159,11 @@ Tests for the proposal are added to the JSON Schema Test Suite.
155159
@@ TODO: Identify a location within the test suite for proposals. @@
156160
```
157161

162+
Once an initial draft of the proposal has been completed and published, the feature moves into Experimentation.
163+
158164
### Experimentation
159165

160-
Once the initial proposal has been completed, implementations may begin to support the new feature.
166+
Implementations may begin to support the new feature.
161167

162168
Feedback from implementers and users are expected to result in refinements to the proposal, which will then be updated in the implementations.
163169

0 commit comments

Comments
 (0)