diff --git a/2/README.md b/2/README.md index fd4ff6c..7131b86 100644 --- a/2/README.md +++ b/2/README.md @@ -2,7 +2,8 @@ This document describes a consensus-oriented specification system (COSS) for bui * Name: rfc.unprotocols.org/spec:2/COSS (2/COSS) * Editor: Pieter Hintjens -* Contributors: André Rebentisch , "Alberto Barrionuevo" , Chris Puttick +* Contributors: André Rebentisch , "Alberto Barrionuevo" , Chris Puttick , +Yurii Rashkovskii * State: draft ## License @@ -75,7 +76,7 @@ Every specification has an independent lifecycle that documents clearly its curr A specification has six possible states that reflect its maturity and contractual weight: -![Lifecycle diagram](coss-lg.png) +![Lifecycle diagram](lifecycle.png) ### Raw Specifications All new specifications are **raw** specifications. Changes to raw specifications can be unilateral and arbitrary. Those seeking to implement a raw specification should ask for it to be made a draft specification. Raw specifications have no contractual weight. @@ -87,18 +88,13 @@ When raw specifications can be demonstrated, they become **draft** specification ### Stable Specifications When draft specifications are used by third parties, they become **stable** specifications. Changes to stable specifications should be restricted to errata and clarifications. Stable specifications are contracts between editors, implementers, and end-users. -### Legacy Specifications +### Deprecated Specifications -When stable specifications are replaced by newer draft specifications, they become **legacy** specifications. Legacy specifications should not be changed except to indicate their replacements, if any. Legacy specifications are contracts between editors, implementers and end-users. +When stable specifications are replaced by newer draft specifications, they become **deprecated** specifications. Deprecated specifications should not be changed except to indicate their replacements, if any. Deprecated specifications are contracts between editors, implementers and end-users. ### Retired Specifications -When legacy specifications are no longer used in products, they become **retired** specifications. Retired specifications are part of the historical record. They should not be changed except to indicate their replacements, if any. Retired specifications have no contractual weight. - -### Deleted Specifications -When raw or draft specifications are abandoned, they become **deleted** specifications. To change a deleted specification, the editor should first make it a raw specification again. Deleted specifications have no contractual weight. - -Raw and draft specifications SHOULD BE considered abandoned if they are not changed or used within a period of 3-6 months for raw and 9-18 months for draft specifications. +When deprecated specifications are no longer used in products, they become **retired** specifications. Retired specifications are part of the historical record. They should not be changed except to indicate their replacements, if any. Retired specifications have no contractual weight. ## Editorial control diff --git a/2/coss-lg.png b/2/coss-lg.png deleted file mode 100644 index e78b3fa..0000000 Binary files a/2/coss-lg.png and /dev/null differ diff --git a/2/lifecycle.png b/2/lifecycle.png new file mode 100644 index 0000000..8f4bc71 Binary files /dev/null and b/2/lifecycle.png differ diff --git a/2/lifecycle.uml b/2/lifecycle.uml new file mode 100644 index 0000000..c70f451 --- /dev/null +++ b/2/lifecycle.uml @@ -0,0 +1,28 @@ +@startuml +title Consensus Oriented Specification System Life Cycle +footer rfc.unprotocols.org/spec:2/COSS + +skinparam activity { + StartColor red + BarColor SaddleBrown + EndColor Silver + BackgroundColor Peru + BackgroundColor<< Begin >> Olive + BorderColor Peru +} +"Create" -right-> "RAW + Use: mockups + Goal: design it" +-right-> "DRAFT + Use: prototypes + Goal: prove it" +-down-> "STABLE + Use: products + Goal: deploy it" +-left-> "DEPRECATED + Use: products + Goal: replace it" +-left-> "RETIRED + Use: historical + Goal: study it" +@enduml diff --git a/SUMMARY.md b/SUMMARY.md index 29063f7..4252716 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -6,6 +6,5 @@ * [2/COSS](2/README.md) * Stable * [1/C4](1/README.md) -* Legacy +* Deprecated * Retired -* Deleted