{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"This is a proposal how CAMARA can re-use project maturity levels of ","type":"text"},{"text":"CNCF","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.cncf.io/project-metrics/"}}]},{"text":" in API lifecycle management.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each CAMARA API can have a maturity level of sandbox, incubating, or graduated that reflects the advancements of API specifications process and obligations of the subprojects in the CAMARA Release Management Proces. The “archived” status can be added for closed/not-finished specifications.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here the issue ","type":"text"},{"text":"Consider including Alpha and Beta labels to API versions #13","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/camaraproject/ReleaseManagement/issues/13"}}]},{"text":" ","type":"text"},{"text":"is also addressed. ","type":"text"},{"text":"Semantic Versioning is related to software development, for API specification it can be referenced as the Best Practice. For prerelease identifiers arbitrary strings may be used, \"alpha\" and \"beta\" are just common convention.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11 < 1.0.0-rc.1 < 1.0.0","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"0c0ca9e5-e22a-4cf9-8f8b-d1ffa41b6727"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"For API specifications in early development (before reaching version 1.0.0) using these identifiers can be helpful when multiple versions are exposed to developers for testing APIs in their applications.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The proposal can be also related to ","type":"text"},{"text":"Readiness Checklist step 6 update proposal #16","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/camaraproject/ReleaseManagement/issues/16"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sandbox","type":"text"}]},{"type":"paragraph","content":[{"text":"Sandbox is the initial level for APIs starting development within CAMARA Project.","type":"text"}]},{"type":"paragraph","content":[{"text":"There are no specific requirements related to API Readiness checklist items for sandbox APIs.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Participation in meta-relase: ","type":"text","marks":[{"type":"strong"}]},{"text":" no obligation","type":"text"}]},{"type":"paragraph","content":[{"text":"If API is included in the meta-release, it must support all the release requirements.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"API Version:","type":"text","marks":[{"type":"strong"}]},{"text":" 0.x.y","type":"text"}]},{"type":"paragraph","content":[{"text":"The following objects are used in OAS:","type":"text"}]},{"type":"paragraph","content":[{"text":"version: 0.x.y","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"...","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":" basePath:","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":" default: endpoint/v0alpha . . . /v0alpha1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Incubating","type":"text"}]},{"type":"paragraph","content":[{"text":"Incubating API should be part of each CAMARA meta-release.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following API Readiness checklist items should be supported:","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"No","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Deliverables/Criteria","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" Incubating API support","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API Spec","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API Implementation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API Documentation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"User Stories","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API test cases and documentation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Tested by at least 2 operators","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Security review","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Participation in meta-relase: ","type":"text","marks":[{"type":"strong"}]},{"text":" mandatory","type":"text"}]},{"type":"paragraph","content":[{"text":"Participation in at least 1 meta-release (as sandbox API) is required to accept it into CAMARA Incubator.","type":"text"}]},{"type":"paragraph","content":[{"text":"API included in the meta-release must support all the release requirements.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"API Version:","type":"text","marks":[{"type":"strong"}]},{"text":" 0.x.y","type":"text"}]},{"type":"paragraph","content":[{"text":"The following objects are used in OAS:","type":"text"}]},{"type":"paragraph","content":[{"text":"version: 0.x.y","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"...","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":" basePath:","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":" default: endpoint/v0beta . . . /v0beta1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Graduated","type":"text"}]},{"type":"paragraph","content":[{"text":"API is graduated when the release 1.0.0 is reached with all API Readiness checklist mandatory items supported:","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"No","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Deliverables/Criteria","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" Incubating API support","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API Spec","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API Implementation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"N","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API Documentation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"User Stories","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"API test cases and documentation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Tested by at least 2 operators","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Security review","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Y","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Participation in meta-relase: ","type":"text","marks":[{"type":"strong"}]},{"text":" mandatory","type":"text"}]},{"type":"paragraph","content":[{"text":"API included in the meta-release must support all the release requirements.","type":"text"}]},{"type":"paragraph","content":[{"text":"If needed the new API release should be prepared for meta-release, but without breaking changes .","type":"text"}]},{"type":"paragraph","content":[{"text":"New major version (e.g. 1->2) is needed when breaking changes are introduced.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"API Version:","type":"text","marks":[{"type":"strong"}]},{"text":" v.x.y v>0","type":"text"}]},{"type":"paragraph","content":[{"text":"The following objects are used in OAS:","type":"text"}]},{"type":"paragraph","content":[{"text":"version: 1.x.y","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"...","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":" basePath:","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":" default: endpoint/v1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"References","type":"text"}]},{"type":"paragraph","content":[{"text":"Semantic Versioning 2.0.0 ","type":"text"},{"text":"https://semver.org/","type":"text","marks":[{"type":"link","attrs":{"href":"https://semver.org/"}}]}]},{"type":"paragraph","content":[{"text":"Example: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11 < 1.0.0-rc.1 < 1.0.0.","type":"text"}]}],"version":1}