diff --git a/README.md b/README.md index 719b9a1..e82cc3f 100644 --- a/README.md +++ b/README.md @@ -5,3 +5,25 @@ This repository is the primary reference for the Clarity language. Note that this reference is not normative. It may include details that are specific to the Stacks blockchain implementation of Clarity itself, and should not be taken as a specification for the Clarity language. Such a specification may come someday, but this is what we have for now. You can read [the language reference](https://github.com/clarity-lang/reference/blob/master/reference.md). + +# Contributing + +Anyone can open issues on this repository to suggest improvements to the Clarity language. +The point is to have early discussions here before moving to an actual SIP. + +- Make sure that a similar issue doesn't already exists (check the closed ones) +- Be specific +- Give use cases and usage examples + +## From candidate to SIP + +Once an issue is opened, it can have the tag `clarity-3-candidate`, meaning that the idea will be considered to be added to the upcoming version of Clarity. +While the issue has this tag, it's time to debate, brainstorm and improve the specification. + +Moving forward, the proposal will fall under one of these tags: +- `need-refinement` the proposal isn't specific enough and nee to be refined +- `sip-in-progress` meaning that the candidate will be promoted to a SIP +- `icebox` meaning that this idea won't be included in the next Clarity version but maybe in later ones +- `wontfix` this idea will not be included in Clarity (and close the issue). + +The Blockchain team should be responsible for setting these tags.