diff --git a/PROCESS.md b/PROCESS.md index d9b93adb..c3b55a90 100644 --- a/PROCESS.md +++ b/PROCESS.md @@ -122,11 +122,9 @@ At least two (2) Core Team members must have implemented prototypes before the c 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. -The proposal will use the [Proposal Template]() and be stored in this repository's `proposals` folder. +The proposal will use the [Proposal Template](./proposals/proposal-template.md) and be stored in this repository's `proposals` folder. -```diff -@@ TODO: Define Proposal Template and fill in the link. @@ -``` +Additionally, a draft ADR will be included using the file name of the proposal document with an `-adr` suffix: `{proposal-file-name}-adr.md`. This ADR will include additional information from the "Concept" discussion. Proposed keywords will be added to the appropriate vocabulary meta-schemas in: @@ -169,7 +167,9 @@ If a proposal cannot advance to the next stage, it may be removed. The proposal ### Stable -The proposal is incorporated into the specification in the `main` branch, and the feature will be required as of the next release. +The feature is incorporated into the specification in the `main` branch as specified by the proposal document, and the feature will be required as of the next release. + +The draft ADR is completed, dated, and moved to the `adr` folder. The appropriate vocabulary meta-schema in the `main` branch is updated to include a subschema that validates the feature's syntax requirements. This will be made available with the next release. diff --git a/proposals/proposal-template.md b/proposals/proposal-template.md new file mode 100644 index 00000000..62381696 --- /dev/null +++ b/proposals/proposal-template.md @@ -0,0 +1,92 @@ +# JSON Schema Proposal: + +## Abstract + + + +This document proposes a change to the ??? specification by adding ???. + +## Current Status + + + +## Note to Readers + + + +The issues list for this proposal can be found at +. + +For additional information, see . + +To provide feedback, use this issue tracker or any of the communication methods +listed on the homepage. + +## Table of Contents + +## Conventions and Terminology + +All conventions and terms used and defined by the JSON Schema Core specification +also apply to this document. + +## Overview + +### Problem Statement + + + +### Solution + + + +### Limitations + + + +## Change Details + + + +## [Appendix] Change Log + +* [MMMM YYYY] Created + +## [Appendix] Champions + +| Champion | Company | Email | URI | +|----------------------------|---------|-------------------------|----------------------------------| +| Your Name | | | < GitHub profile page > |